AD-A1S4  <44  DEVELOPMENT  OF  fl  COMPUTER  HIDED  DESIGN  PRCKHSE  FOR 
CONTROL  SVSTEH  DESIGN  fl.  .  (U)  AIR  FORCE  INST  OF  TECH 
HRIOHT -PATTERSON  HFB  OH  SCHOOL  OF  ENGI. . 
UNCLASSIFIED  S  K  MHSHIKO  ET  HL.  DEC  83  F/O  9/2 


W 


NL 


AFIT/GE/ENG/85D-46 


m 


DTIC 


ZLECTE 

FEB  1  3  1986 

D 


DEVELOPMENT  OF  A  COMPUTER  AIDED  DESIGN 
PACKAGE  FOR  CONTROL  SYSTEM  DESIGN 
AND  ANALYSIS  FOR  A  PERSONAL  COMPUTER 
(ICECAP-PC) 

THESIS 

Volume  II  of  II 

Susan  K.  Mashiko  Gary  C.  Tarczynski 

Captain,  L'SAF  Captain,  USAF 

AFIT/GE/ENG/85D-46 


Approved  for  public  release;  distribution  unlimited 


■r.v.v.V  '  ■  V  '-v'.- 


*--»  -  * 


I 


I.'*-1 


Appendix  D:  Data  Dictionary 


This  appendix  contains  the  data  dictionary.  The  name, 
description,  make-up,  source,  destination  and  the  use  of  !■£-£ 

e$ch  of  the  variables,  constants,  type  definitions  and  pro- 
cddures  are  contained  in  this  section.  The  entries  are 

self-explanatory.  cZe** 


C. .  j 


S'. 


DATA  DICTIONARY  FOR  ICECAP- PC 


****************************************************************** 

Name:  abbrev_code 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  character  is  attached  to  the  beginning  of  an 

abbreviation  of  a  command  word.  It  indicates  to 
the  code  that  it  is  the  abbreviation  for  some  other 
word. 

Makeup:  Char 

Source: 

Dest inat ion: 

Used  In:  val_n_dec 

****************************************************************** 

****************************************************************** 
Name:  abort 

Aliases:  None 

Type  Of  Entry:  Label 

Description:  This  is  a  label  for  a  goto  statement. 

Make_up:  Char 

Source: 

Destination : 

Used  In:  form 

****************************************************************** 


Name:  abort2 

Aliases:  None 

Type  Of  Entry:  Label 

Description:  This  is  a  label  for  a  goto  statement. 

Make_up:  Char 

Source: 

Destination : 

Used  In:  form 

****************************************************************** 


Name : 
Aliases : 
Type  Of 
Descript 

Make  up: 
Source : 
Dest inat 
Used  In: 


abort_command 

None 

Entry:  Global  variable  and  data 
ion:  This  variable. is  the  flag 

the  command  input  by  the 
boolean 

declared  in  icecappc 

ion: 

get_int,  get_strng 


flow 

that 

user 


indicates  whether 
is  the  one  to  abort. 


readcom. 


FILE:  DATA  DICTIONARY  D-2 


get_cmd,  recover,  update 

get_real,  get_r_num,  get_fact, 

get_unfact,  poly,  gettf, 

matrxmanipl,  matrxmanip2,  get_matrx_entries, 

matrxadd,  mmatrxmlt,  get_mat, 

matrxsub,  inroot,  delroot, 

matrxinv,  form,  ppoly, 

mmatrix,  get_poly,  get  poly  name 

at***************************************************************** 

****************************************************************** 

Name:  abort_str 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  Literal  that  indicates  abort_command 

Make_up:  Character  literal  {$) 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  input  by  the  user 

*************************************************  **.* ************** 

****************************************************************** 
Name:  again 

Aliases:  None 

Type  Of  Entry:  Label 

Description:  Label  for  a  goto  statement. 

Makeup:  Character 

Source: 

Destination: 

Used  In:  get_poly_name 

****************************************************************** 

****************************************************************** 

Name:  amat 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  matrix. 

Make_up:  matrix 

Source: 

Destination: 

Used  In:  matrxadd,  matrxsub,  mmatrxmlt, 

smatrxmlt,  ;matrxtran 

****************************************************************** 

****************************************************************** 

Name:  apoly 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  polynomial. 
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polynomial 


Make_up: 

Source : 

Destination: 

Used  In:  spolymlt,  polymlt,  polysub, 

poly add 

****************************************************************** 


★★It*************************************************************** 

Name:  as_assigned 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  Literal  that  indicates  input  is  from  the  source  as 

indicated  by  the  status  of  the  in_terminal  flag 
Character  literal 
Declared  in  icecappc 


Make_up: 
Source : 
Destination : 
Used  In: 


get_int , 
recover, 
get_fact , 
get  poly  name. 


disp_line,  prompt_cmd, 

gettf,  get_real, 

make_pretty,  update, 

ccopyy,  get_r_num, 

ppoly,  make_pretty_small_matrix ,  get_mat, 

disppoly ,  make_pretty_large_matr ix_one , 

inroot,  delroot,  disp_matrx, 

mmatr ix 

****************************************************************** 


** **************************************************************** 

Name :  b 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  a  temporary  storage  area 

the  polynomial. 

Make_up:  bl 

Source : 

Destination: 

Used  In:  roots 

a***************************************************************** 


****************************************************************** 
Name:  bl 

Aliases:  None 

Type  Of  Entry:  Variable  ; 

Description:  This  variable  is  used  as  a  temporary  storage  area 

the  polynomial. 
array[  1..30  ]  of  real 


Make  up: 


★  ★  ★  ★ 


★  *  ★  ★ 


Name:  backspace 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  Decimal  ASCII  value  for  the  backspace  character. 

Make_up:  Integer 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  del_lst  ch,  ck_chr,  get_strnq 

********************  *7*  *********************************  *  ********* 


Name : 
Aliases : 
Type  Of 
Descript 


Make_up: 
Source: 
Dest inat 
Used  In: 


blanks 

None 

Entry:  Global  variable 

ion:  A  string  of  blank  characters  used  to  ’erase’  a  line 

on  the  CRT.  Can  also  be  used  as  a  source  of  blank 
characters  to  clear  strings  throughout  the  program, 
stringt  screen_size  ] 

Declared  in  icecappc 
ion:  N/A 

pause,  get_data,  clearmsg, 

prompt_cmd,  proces_error ,  recover, 

update,  get_r_num,  get_poly_name , 

ppoly,  del root 


****************************************************************** 
Name:  bld_stat_l ine 

Type:  Procedure 

Description:  This  procedure  builds  the  status  line  from  initial¬ 
ization  data  from  disk  staorage.  The  data  is  in  param 
group  1. 

Global  Variables  Used:  stat^line,  help_level,  temp, 

printer,  trans 

Global  Variables  Changed:  stat__line 

Global  Constants  Used:  None- 


Passed  Variables: 

help_level , 

temp, 

printer 

trans 

Returned: 

None 

Files  Read: 

None 

Files  Written: 

None 

Aliases : 

None 

Procedures  Called: 

None 

Called  By: 

get_data 

Version: 

1.2 

Date : 

18  Oct  83 

Author:  Vincent  M.  Parisi 

II,  Capt,  USAF 

FILE:  DATA  DICTIONARY  D-5 


I  • 


Contained  In  File:  GETDAT.PAS 

****************************************************************** 

****************************************************************** 

Name:  bmat 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  matrix. 

Make_up:  matrix 

Source: 

Destination: 

Used  In:  matrxadd,  matrxsub,  mmatrxmlt, 

smatrxmlt,  matrxtran 

****************************************************************** 

****************************************************************** 

Name:  bpoly 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  polynomial. 

Makeup:  polynomial 

Source : 

Destination: 

Used  In:  spolymlt,  pulymlt,  polysub, 

poly add 

****************************************************************** 

****************************************************************** 
Name:  buffer 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  This  is  the  type  definition  of  the  structure  that 

holds  the  user  input  commands  once  it  has  been 
separated  into  individual  words,  one  word  per 
storage  location. 

Make_up:  array[  1 . . buf f ers ize  ]  of  stringt  wordsize  ] 

Source:  Declared  in  icecappc 

Destination:  N/A 
Used  In:  icecappc 

****************************************************************** 

*****************************$************************************ 
Name:  buf ferpointer 

Aliases:  None 

Type  Of  Entry:  Variable  and  data  flow 

Description:  This  variable  points  to  the  next  location  in  the 

cmdbuffer  that  will  receive  the  next  command 
word. 

Make_up:  Integer 


ff  T.f.R  •  DATA  DICTIONARY 


V* 


readcom 


Source:  get_cmd, 

Destination:  N/A 

Used  In:  get_cmd,  readcom,  proces_error 

*★★***★*****★*★★****★******★★***★★★******★★**★★***★*******★*★★★★** 

****************************************************************** 
Name:  buffersize 

'.liases:  None 

Type  Of  Entry:  Global  constant 

Description:  Maximum  number  of  individual  words  allowed  in  a  user 

input  command. 

Makeup:  Integer  (6) 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  icecappc,  get_line,  readcom, 

val_n_dec,  displa_commandword,  help, 

select_rout ine 

★★★★a************************************************************* 

Name:  c 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  a  temporary  storage  area 

the  polynomial. 

Make_up:  cl 

Source: 

Dest  inat ion: 

Used  In:  roots 

****************************************************************** 

****************************************************************** 

Name:  c 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  in  the  IBM  unique  procedure 

stdout 

Make_up:  char 

Source : 

Destination: 

Used  In:  stdout 

*****************************  *.*  *********************************** 

****************************************************************** 

Name:  cl 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  a  temporary  storage  area 

the  polynomial. 
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****************************************************************** 

Name:  Cl 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Col  +  width  -  1 

Make_up:  Integer 

Source : 

Destination: 

Used  In:  rectangle 


****************************************************************** 
Name:  call_routine 

Aliases:  None 

Type  Of  Entry:  Global  variable  and  data  flow 

Description:  This  variable  is  the  name  of  the  routine  to  call 

to  accomplish  the  desired  action  from  the  user 
input . 

Make_up:  cmdword 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  get_data,  get_cmd, 

val_n_dec,  select_rout ine 


A***************************************************************** 

Name:  ccopyy 

Type:  Procedure 

Description:  This  procedure  manages  the  copy  function.  It  gets  the 

source  and  destination  location  then  performs  the 
copy  operation.  (  called  ccopyy  because  of  the 
compiler  function  called  copy  ) 

Global  Variables  Used:  cmdbuffer 

Global  Variables  Changed:  None 
Global  Constants  Used:  as_assigned 

Passed  Variables:  cmdbuffer  ; 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear,  gotoxy,  trim,  out_string, 

get_locat ion ,  move_matrix,  move_poly, 

move_tf,  highlight,  nohighlight,  pause. 


FILE:  DATA  DICTIONARY 
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Called  By: 


disp_msg 
select  routine 


Version:  2.0 

Date:  22  Sep  85 

Author:  Vincent  M.  Parisi  II,  Capt ,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt  ,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  COPY. PAS 


Aliases: 
Type  Of 
Descript 

Make_up : 
Source : 
Dest inat 
Used  In: 
****** 


cd 
None 

Entry:  Variable 

ion:  This  is  a  polynomial,  which  is  used  as  a  temporary 

storage  area  for  the  CLTF  denominator  polynomial, 
polynomial 


form 


Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  input  from  the  user  in  the  get_strng  procedure. 

Appended  onto  the  string  if  a  valid  ASCI  I* cnaracter 
ignored  if  a  control  character. 

Make  up:  Char 


Make_up : 
Source : 
Destination 
Used  In: 


get  chr. 


get  int. 


ck_chr , 

* 


get  real 


Name : 

change  msg 

Aliases : 

None 

Type  Of  Entry 

:  Constant 

Description : 

The  constant  is  the  message  number  for  help 

Make  up: 

Integer  ; 

Source : 

Dest inat ion : 

Used  In: 

help 

check 


DATA  DICTIONARY 


Aliases:  None 

Type  Of  Entry: 

Variable 

that  is  used  to 

Descript  ion : 

This  is  a  temporary  storage  area 

compare  the  passed  command  word 
keywords . 

against  certain 

Make_up: 

Source : 
Destination: 

cmdword 

Used  In: 

define 

Name:  check  word 

Type:  Function 

Description:  This  procedure  checks  the  word  to  see  if  it  matches 

the  dictionary  entries. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  decode,  command 

Returned:  command,  check_word 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  trim 

Called  By:  val_n_dec 


Version:  1.1 

Date:  29  Oct  84 

Author:  Paul  A.  Moore,  Capt,  USAF 

Contained  In  File:  VALNDEC.PAS 

★★a*************************************************************** 

****************************************************************** 

Name:  chg_col 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  column  location  of  the  entry  to  be  changed 

in  the  selected  matrix. 

Make_up:  Integer 

Source : 

Destination:  ; 

Used  In:  chgmat 

****************************************************************** 

★★★★★★★★★★★★★★★★★★★♦★★★★★★★★★★★★★a******************************** 

Name:  chg_row 

Aliases:  None 

Type  Of  Entry:  Variable 


FILE:  DATA  DICTIONARY  D-10 


Description:  This  is  a  row  location  of  the  entry  to  be  changed 

in  the  selected  matrix. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  chgmat 

*****★***★*★★★**★***★***★★★**★**★***★*★★★★******★★***★****★**★**** 

**★*****★***★*************★★*★★*★*★*★***★★**★★★*★****★★★*★*****★*★ 
Name:  chgmat 

Type:  Procedure 

Description:  This  procedure  will  display  the  requested  matrix 
on  the  screen  and  ask  the  user  which  row  and  col 
location  should  be  modified  and  will  store  the  result 
in  the  original  location. 

Global  Variables  Used:  abort_command ,  cmdbuffer 

Global  Variables  Changed:  None 

Global  Constants  Used:  as_assigned,  crt_only 

Passed  Variables:  cmdbuffer,  wordnumber 

Returned:  None 

Files  Read:  MATRIX . DAT 

Files  Written:  MATRIX.DAT 

Aliases:  None 

Procedures  Called:  trim,  gotoxy,  disp_msg,  out_string, 

clear_msg,  out_real,  clear,  pause, 

get_r_num,  get_strng,  ucase,  disp_matrx, 

get_int,  make_pretty^small_matrix , 

make_pretty_large_matrTx_one , 
make_pretty_large_matr ix_two 

Called  By:  modify 

Version:  1.0 

Date:  22  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MODIFY. PAS 

****★★**★**★****★*★*******★*★**★*★******★******★*****★**★*★*★★★*** 


Name:  choice 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  object  that  is  passed  to  the  procedure. 

Make_up:  cmdword 

Source: 

Dest inat ion: 

Used  In:  chgmat,  inroot,  delroot, 

poly_into_storage,  form,  disp_matrx, 

poly_f rom_storage ,  disppoly 


FILE:  DATA  DICTIONARY 


D-ll 


****************************************************************** 
Name:  chrl 

Aliases:  None 

Type  Of  Entry:  Data  flow 

Description:  This  variable  indicates  to  get_strng  the  lower 

bound  of  ASCII  characters  that  can  be  accepted  on 
input . 

Makeup:  Char 

Source:  get_strng 

Destination:  N/A 
Used  In:  get_strng 

★a**************************************************************** 

Name:  chr2 

Aliases:  None 

Type  Of  Entry:  Data  flow 

Description:  This  variable  indicates  to  get_strng  the  upper 

bound  of  ASCII  characters  that  can  be  accepted  on 
input . 

Make_up:  Char 

Source:  get_strng 

Destination:  N/A 
Used  In:  get_strng 

*****************************************************  ************* 
★★★★★★•ft*********************************************************** 

Name:  ck_chr 

Type:  Procedure 

Description:  This  procedure  checks  each  character  input  to  see 
if  it  is  a  delete  or  a  backspace.  It  it  is  the 
screen  is  updated  appropriately  and  the  destin¬ 
ation  string  is  changed. 

Global  Variables  Used:  strng 

Global  Variables  Changed:  strng 

Global  Constants  Used:  del,  backspace 

Passed  Variables:  ch,  strng 

Returned:  strng 

Files  Read:  None 

Files  Written:  None  : 

Aliases:  None 

Procedures  Called:  del_lst_ch 
Called  By: 

Version:  1.2 

Date:  18  Oct  83 

Author:  Vincent  M.  Parisi  II,  Capt ,  USAF 


FILE:  DATA  DICTIONARY 
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Contained  In  File:  GETINT.PAS 

★★★★★★★★★★★★★★★★★★★★★★a******************************************* 

****************************************************************** 
Name:  clear 

Type:  Procedure 

Description:  This  procedure  clears  the  screen  and  homes  the  cursor 


If 

the  status  line 

is  on  the  status 

line  is  di 

Global  Variables 

Used:  term. 

stat_on,  stat_ 

line 

Global  Variables 

Changed:  None 

Global  Constants 

Used:  None 

Passed  Variables: 

None 

Returned: 

None 

Files  Read: 

None 

Files  Written: 

None 

Aliases : 

None 

Procedures  Called:  gotoxy 

Called  By: 

title_slide. 

get_data, 

disp_msg , 

clear_msg , 

get_cmd, 

recover , 

update , 

ccopyy , 

help, 

gettf , 

get  matrix  entries, 

matrxadd, 

get  mat, 

disp, 

disptf , 

modi f  y , 

chgmat , 

matrxinv , 

inroot , 

del root , 

form, 

disppoly, 

disp_matrx 

ppoly, 

mmatrix, 

polymlt , 

define. 

get_poly. 

mmatrxmlt 

Version: 

2.0 

Date: 

21  Oct  83 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 

***************************************************************** 

Name:  clpir_msg 

Type:  Pr^  :edure 

Description:  The  procedure  clears  the  message  indicated  by  the 

msg_num  from  the  screen.  It  is  the  programmer's 
responsibility  to  position  the  cursor  prior  to  calling 
this  routine.  The  cursor  should  be  placed  a*  the 
beginning  of  the  line  where  you  wish  the  message 
erased. 

Global  Variables  Used:  msg_dir,  blanks 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only 

Passed  Variables:  msg_num 

Returned:  None 

Files  Read:  None 


FILE:  DATA  DICTIONARY 
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Files  Written: 
Aliases: 

Procedures  Called: 
Called  By: 

None 

None 
clear, 
disp_msg , 
update , 
roots , 
mmatrxmlt , 
form. 

out_str ing 
proces_error , 
get_real , 
gettf , 
chgmat , 

get_poly_name , 

recover, 
get_r act , 
get_mat , 
delroot , 
get_matrx  name 

Version : 

Date: 

1.3 

18  Oct  83 

Author:  Vincent  M.  Parisi  II,  Capt ,  USAF 

Contained  In  File:  MSG. PAS 

****************************************************************** 

****************************************************************** 
Name:  clearscreen 

Type:  Procedure 

Description:  This  procedure  clears  the  screen  and  homes  the  cursor 

If  the  status  line  is  on  the  status  line  is  displayed. 
Global  Variables  Used:  term,  stat_on,  stat_line 

Global  Variables  Changed:  None 

Global  Constants  Used:  term_length,  stat_line_width 

Passed  Variables:  None 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  icecappc 

Version:  1.0 

Date:  12  Dec  84 

Author:  Paul  A.  Moore,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 

****************************************************************** 

Name:  cmat 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  matrix.? 

Make_up:  matrix 

Source: 

Destination: 

Used  In:  matrxadd,  matrxsub,  mmatrxmlt 

****************************************************************** 

****************************************************************** 
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Name :  cmd 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  string  of  char. 

Make_up :  cmdwo  rd 

Source: 

Dest inat ion : 

Used  In:  readcom,  val_n_dec 

****************************************************************** 

****************************************************************** 
Name:  cmdbuffer 

Aliases:  None 

Type  Of  Entry:  Global  variable  and  data  flow 

Description:  This  is  a  buffer  of  individual  commandwords  input 

by  the  user. 

Make_up:  buffer 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  icecappc,  get_cmd,  displa_commandword, 

val_n_dec,  readcom,  proces_error , 

ccopyy,  help,  disp, 

inroot,  modify,  del root, 

select_rout ine ,  chgmat,  ppoly, 

define,  get_poly_name 

****************************************************************** 

****************************************************************** 

Name:  cmd_col 

Aliases:  None 

Type  Of  Entry:  Constant  and  data  flow 

Description:  This  is  the  column  that  is  used  as  the  beginning  o 

user  entered  commands. 

Make_up:  Integer 

Source:  get_cmd 

Destination:  N/A 
Used  In:  get_cmd 

****************************************************************** 

****************************************************************** 
Name:  cmd_len 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  length  of  the  command. 

Make_up:  Integer 

Source : 

Dest inat ion : 

Used  In:  check_word 

****************************************************************** 
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Name:  cmd_row 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  constant  is  the  row  that  the  cursor  is 

positioned  at  for  user  entered  commands. 

Make_up:  Integer 

Source:  get_cmd 

Destination:  N/A 

Used  In:  get_cmd 

****************************************************************** 

****************************************************************** 

Name:  cmdword 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  This  is  the  type  definition  of  a  short  string 

which  can  then  be  used  as  a  parameter  for  passing 
between  procedures. 

Make_up:  string[  wordsize  ] 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  icecappc,  check_word,  val_n_dec, 

trim,  displa_commandword,  get_cmd, 

get_location,  ccopyy,  poly, 

help,  gettf,  polymanip, 

polymanip2,  get^_mat,  select_rout  ine, 

disppoly,  modify,  dispmatrx, 

poly_into_storage,  matrxmanip2,  get_poly, 
poly_f rom_storage,  define 

A***************************************************************** 

★★★a************************************************************** 
Name:  cmd_word 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  equated  to  the  cmdbuf f er [ word_num] 

Make_up:  cmdword 

Source:  displa_commandword 

Destination:  N/A 

Used  In:  displa  commandword 


Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  polynomial,  which  is  used  as  a  temporary 

storage  area  for  the  CLTF  numerator  polynomial. 
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Make_up:  polynomial 

Source: 

Destination: 

Used  In:  form 

★★Hr*************************************************************** 

****************************************************************** 
Name:  coeff_poly 

Aliases:  None 

Type  Of  Entry:  variable 

Description:  The  variable  is  a  temporary  storage  area  for  the 

polynomial . 

Make_up:  arrayt  l..maxdegl  ]  of  real 

Source: 

Destinat ion: 

Used  In:  roots 

****************************************************************** 

****************************************************************** 
Name:  col 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  screen  column  portion  of  the 

cursor  position  information. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  prompt_cmd,  get_r__num,  make_pretty_large_matr ix_one, 

disp_matrx,  chgmat,  get_poly_name , 

make_pretty_smalljmatr ix,  get_matrx_entr ies , 
gotoxy 


4 

•  .!*  .1 


Name: 

col_element 

Aliases: 

None 

-*  y, 

Type  Of  Entry: 

Variable 

Description: 

This  variable 

is  a  counter  for  the  display  and 

modi f icat ion 

of  a  matrix. 

4 

• 

Make_up: 

Integer 

Source : 

Destination: 

*  V  *  •  •  1 

Used  In: 

disp  matrx, 

chgmat,  get_matrx_entr ies 

Description:  This  variable  is  the  column  location  for  the  left 

side  of  the  rectangle. 

Make_up:  Integer 

Source : 

Destination: 

Used  In:  rectangle 

****************************************************************** 

****************************************************************** 
Name:  column_length 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  length  of  the  vertical  column 

of  the  matrix  bracket. 

Make_up:  Integer 

Source : 

Destination: 

Used  In:  lef t_bracket ,  r ight_bracket 

★★★★★★★★★★A******************************************************* 

****************************************************************** 
Name:  column_locat ion 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  column  location  of  the  vertical 

column  of  the  right  matrix  bracket. 

Makeup:  Integer 

Source : 

Destination: 

Used  In:  r ight_bracket 

****************************************************************** 

****************************************************************** 
Name :  command 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  command  word  entered  by  the 

user . 

Make_up:  cmdword 

Source:  check_word 

Destination:  N/A 

Used  In:  check_word  : 

************ ********************************************* ********* 

****************************************************************** 

Name:  complex 

Aliases:  None 

Type  Of  Entry:  Type  definition 

Description:  Record  type  that  contains  each  element  of  the 
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Name:  copy 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  storage  area. 

Make_up:  File 

Source : 

Dest inat ion : 

Used  In:  select_rout ine 

★***************************************************************** 


***************** 

Name :  copy_msg 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  constant  is  the  message  number  of  the  main 

menu  copy  message. 

Makeup:  Integer 

Source: 

Destination : 

Used  In:  help 


********************************************* 

Name :  COPY . PAS 

Type:  File 

Description:  This  file  manages  the  copy  function.  It  gets  the 
source  and  destination  location  then  performs  the 
copy  operation  for  transfer  functions,  polynomials 
and  matrices. 

Procedures  Contained:  get_locat ion ,  move_tf,  move_poly, 

move_matr ix t  gettf 

Version:  3.0 

Date:  22  Sep  85 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt  ,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 


Ul 
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i  > 


Name:  counter 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  the  counter  that  is  set  up  internal  to 

the  spolymlt  procedure. 

Make_up:  integer 

Source : 

Destination: 

Used  In:  spolymlt 

. * **★*★*******★**★★***★*★****★★****★*★*★★★*★*★****★ ★★ 


**************************************************** 


Name:  cpoly 

Aliases:  None 

Type  Of  Entry:  Variable 
Description:  This  is  a  polynomial. 

Make_up:  polynomial 

Source : 

Destination : 

Used  In:  polymlt,  polysub. 


poly add 


Name:  crt 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  This  variable  is  the  flag  that  indicates  whether 

the  output  should  goto  the  CRT,  CRT=true  goes  to 
CRT. 

Make_up:  Boolean 

Source:  Declared  in  icecappc 

Destination : 

Used  In:  icecappc,  out_int,  get_data, 

out_real 

a***************************************************************** 


★a**************************************************************** 

Name:  crt_only 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  Literal  that  indica-tes  that  the  input  is  to  come  only 

from  the  terminal  (  usually  a  CRT/  keyboard  ) 

Make_up:  Character  literal 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  pause,  clear_msg,  prompt_help, 

prompt_cmd,  get_r_num,  recover, 

update,  make_pretty,  gettf, 
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get_poly,  get_poly_name ,  form, 

ppoly,  get_mat,  inroot, 

make_pretty_large_matr ix_one ,  delroot , 
make_pretty_small_matr ix 

****************************************************************** 

****************************************************************** 
Name:  data 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  the  file  structure  that  contains 

the  program  parameters,  and  initialization  values, 
terminal  and  printer  control  codes,  and  command  syntax 
data  structure  as  well  as  the  message  directory. 
Make_up:  data  =  record 

param  :  array[  1 . . num_param_group  ]  of  param_group; 
term  :  array[  1 . . term_length  ]  of  byte; 
printr  :  arrayf  1 . .printer_length  ]  of  byte; 
msg_dir  :  array[  1 . . num_msg_dir  ]  of  msg; 
decode_dict  :  dict_buffer; 
end; 

Source:  Declared  in  msdwtype 

Dest inat ion: 

Used  In: 

****************************************************************** 

****************************************************************** 

Name:  data_file 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Type  file  of  type  data  that  contains  program 

parameters . 

Make_up:  File  of  type  data 

Source : 

Destination: 

Used  In:  get_data 

****************************************************************** 

****************************************************************** 

Name:  dataptr 

Aliases:  None 

Type  Of  Entry:  Variable  ; 

Description:  This  is  a  pointer. 

Make_up:  ''datarecord 

Source : 

Dest  inat ion : 

Used  In:  get_data 

****************************************************************** 
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Name:  datarecord 

Aliases:  None 

Type  Of  Entry:  Type  definition 

Description:  A  record  definition  comprised  of  data. 

Make_up:  datarecord  =  record 

tdata  :  data; 

end; 

Source : 

Dest inat ion : 

Used  In:  get_data 

*★***★****★*★★*****★★*★****★****★★*★★*★★★*****★★***★**★*****★***★* 

******★**★★**★**★***★********★*★**★*****★****★********★★*★****■**** 
Name:  data_recs 

Aliases:  None 

Type  Of  Entry:  Pointer 

Description:  A  pointer  that  points  to  a  record  containing  a 

record  so  the  initialization  data  can  be  disposed  of 
after  it  is  transfered  to  global  storage  areas. 
Make_up:  dataptr 

Source : 

Dest inat ion : 

Used  In:  get_data 

****************************************************************** 

****************************************************************** 

Name:  decode 

Aliases:  None 

Type  Of  Entry:  Data  flow 

Description:  This  data  flow  is  one  line  of  decoding  information 

which  is  used  to  validate  and  decode  a  command 
line  input  by  the  user.  It  is  constructed  in  the 
process  called  get_line. 

Make_up:  Type  dictionary 

Source:  Declared  in  icecappc 

Dest inat ion : 

Used  In:  get_line,  prompt_help,  check_word 

****★****************+******************************************** 


★**★★★★*★★★★*★*★*★★******★★★★★★★***★*★★***★★★**★★***★************* 

Name:  decode_dict  : 

Aliases:  None 

Type  Of  Entry:  Global  file  variable  and  data  flow 

Description:  The  command  syntax  data  structure  which  contains  all 

information  for  uecoding  a  command  and  determine  if 
it  is  valid.  Record  element  of  type  data. 

Make_up:  dict_buffer 

Source:  Declared  in  icecappc 
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Name:  define 

Type:  Procedure 

Description:  This  procedure  will  input  a  polynomial  in  either 

factored  or  polynomial  form. 

Global  Variables  Used:  strng,  abort_command 

Global  Variables  Changed:  strng 

Global  Constants  Used:  None 

Passed  Variables:  cmdbuffer,  wordnumber 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear,  pause,  disp_msg,  gettf, 

getmat,  get_poly,  trim 

Called  By:  select_routine 

Version:  2.0 

Date:  22  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  DEFINE. PAS 


Name:  DEFINE. PAS 

Type:  File 

Description:  This  file  contains  the  procedures  that  handle  the 

logic  for  the  definition  of  various  inputs:  transfer 
functions  and  polynomials. 

Procedures  Contained:  get_poly,  define 

Version:  3.0 

Date:  22  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 


Name:  define_msg 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  constant  is  the  number  of  the  message  for 

the  define  option. 

Make_up:  Integer 

Source : 
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Dest inat ion : 

Used  In:  help 


****** 

Name:  def_obj 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  to  indicate  the  object  that  the 

called  routine  is  to  operate  with. 

Make_up:  cmdword 

Source : 

Destination: 

Used  In:  gettf,  get_mat,  define,  get_poly 


************* 

Name: 

*************  **************************************** 

degreel 

;  ;> 

Aliases: 

None 

Type  Of  Entry 

:  Global  Variable 

^  Description: 

This  variable  is  used  to  indicate  the  degree  of  a 

.  s 

■ 

polynomial  plus  one. 

•-v-v 

Make  up: 

Integer 

Source: 

Declared  in  concons 

Destination: 

Used  In: 

****************************************************************** 

Name:  degree 

Aliases:  None 

Type  Of  Entry:  Global  Variable 

Description:  This  variable  is  used  to  indicate  the  degree  of  a 

polynomial . 

Make_up:  Integer 

Source:  Declared  in  concons 

Destination: 

Used  In:  make_pretty,  roots 

****★' 


de 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  decimal  number  that  represents  the  ASCII  value  for 

the  delete  character. 

Make_up:  Integer 

Source:  Declared  in  icecappc 

Destination:  N/A 
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Name:  del_lst_ch 

Type:  Procedure 

Description:  This  procedure  deletes  the  last  character  from  the 
CRT 


Global  Variables 

Used: 

None 

Global  Variables 

Changed: 

None 

Global  Constants 

Used: 

backspace 

Passed  Variables: 

None 

Returned: 

None 

Files  Read: 

None 

Files  Written: 

None 

Aliases: 

None 

Procedures  Called 

i: 

Called  By: 

ck  chr 

Version:  1.0 

Date:  18  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Contained  In  File:  GETINT.PAS 

****************************************************************** 


****************************************************************** 
Name:  delroot 

Type:  Procedure 

Description:  This  procedure  will  delete  a  root  from  a  polynomial. 

If  the  root  is  complex  the  conjugate  will  also  be 
removed. 

Global  Variables  Used:  blanks,  cmdbuffer,  abort_command 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only,  as_assigned 

Passed  Variables:  cmdbuffer,  wordnumber 

None 

TF&POLS . DAT 
TF&POLS . DAT 
None 

Procedures  Called:  clear,  gotoxy,  disppoly,  trim, 

highlight,  out_string,  nohighlight,  get_int, 

disp_msg,  pause,  clear_msg,  form_poly 

Called  By:  modify 


Returned: 
Files  Read: 
Files  Written 
Aliases: 


Version: 

Date: 

Author: 

Contained 


2.0 

22  Sep  85 

Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
In  File:  DELROOT. PAS 
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Name :  DELROOT . PAS 

Type:  File 

Description:  This  file  will  delete  a  root  from  a  polynomial. 

;  If  the  root  is  complex  the  conjugate  will  also  be 
removed. 

Procedures  Contained:  delroot 

Version:  2.0 

Date:  '  22  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 


* * ****** 


AX 


************************************************************** 
Name:  delu 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  the  delta  value  of  the  u 

variable . 

Make_up:  Real 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 


***************************************************************** 
Name:  delv 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  the  delta  value  of  the  v 

variable . 

Make_up:  Real 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 


****************************************************************** 
Name:  denom 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  when  roots  determines  if  the 

denominator  of  the  polynomial  is  zero. 

Make_up:  Real 

Source: 

Dest inat ion : 

Used  In:  roots 
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m 
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a***************************************************************** 

Name:  denom_deg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  degree  of  the  transfer  func¬ 

tions  denominator. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  gettf 

****************************************************************** 

****************************************************************** 
Name:  denominator 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  polynomial  that  is  the  denom¬ 

inator  of  the  transfer  function. 

Make_up:  Polynomial 

Source : 

Destination: 

Used  In:  gettf,  disptf 

****************************************************************** 

****************************************************************** 
Name:  dest 

Aliases:  None 

Type  Of  Entry:  variable 

Description:  This  variable  determines  where  the  output  will  go. 

c  -  crt 
p  -  printer 
b  -  list_dev 
a  -  asassigned 
Make_up:  Char 

Source:  Declared  in  out_string 

Destination:  N/A 

Used  In:  out_string,  out_int,  out_real 

****************************************************************** 

****************************************************************** 
Name:  destination 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  stor_loc  number  for  the 

destination. 


.  v. 


Destination: 

Used  In:  ccopyy 

I****************************************************************** 

★*******★*★★***★***★★★★★**★*★★***★★★*★*★*******★*****★*★*******★** 
Name,:  dest_loc 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  stor_loc  number  for  the 

destination. 

Make-up:  Integer 

Source: 

Destination: 

Used  In:  move_tf,  move_poly,  move_matr ix , 

ccopyy 

★★★a************************************************************** 
Name:  dict_buffer 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  the  structure  that  contains 

the  command  syntax  data  that  is  read  from  disk  as 
part  of  the  structure  data. 

Make_up:  dict_buffer  =  record 

ptrs  :  array[  l..num_ptrs  ]  of  ptr_recs; 

words  :  array[  l..num_vords  ]  of  str ing[ vordlength] 

abbrev  :  arrayC  l..num_words  ]  of  integer? 

end; 

Source:  Declared  in  msdwtype 

Destinat ion: 

Used  In:  icecappc,  msdwtype,  getline, 

getdata 

****************************************************************** 

****************************************************************** 
Name:  dictionary 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  This  is  the  type  definition  of  an  abstract  record 

which  makes  up  a  data  flow. 

Make_up:  dictionary  =  record  , 

dictword  :  string[  words ize  ]; 

matchp  :  integer; 

nomatchp  :  integer; 

end; 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  icecappc,  check_word,  get_line 
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****************************************************************** 

★★★★♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★a****************** 

Name:  dimension 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  dimension  of  the  matrix. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  matrxinv 

****************************************************************** 

****************************************************************** 
Name:  disp 

Type:  Procedure 

Description:  This  procedure  contains  the  logic  to  diaplay  the 

selected  DISPLAY  option  on  the  screen. 

Global  Variables  Used:  cmdbuffer 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  cmdbuffer,  wordnumber 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  disptf,  trim,  ppoly,  clear, 

mmatrix,  dispjnsg,  pause 
Called  By:  select_routine 

Version:  1.0 

Date:  4  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  DISP. PAS 

*********************************************************x*x****** 
********************************************************T*  ******* 

Name:  displa_commandword 

Type:  Procedure 

Description:  This  procedure  displays  the  commandword  pointed  to  ■ 

by  word_num.  , 

Global  Variables  Used:  cmdbuffer 

Global  Variables  Changed:  None 

Global  Constants  Used:  wordsize,  buffersize 

Passed  Variables:  cmdbuffer,  word_num 
Returned:  None 

Files  Read:  None 

Files  Written:  None 
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Aliases:  None 

Procedures  Called:  out_string,  trim 

Called  By:  get_cmd,  proces_error 

Version:  1.1 

Date:  30  Jun  84 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Modifier:  Paul  A  Moore,  Capt,  USAF 

Contained  In  File:  DISPLAYC.PAS 

****************************************************************** 

****************************************************************** 
Name:  DISPLAYC.PAS 

Type:  File 

Description:  This  file  contains  the  procedure  to  display  the 
commandword  pointed  to  by  word_num. 

Procedures  Contained:  displa_commandword 
Version:  1.1 

Date:  30  Jun  84 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

*****************************************  ** *********************** 

****************************************************************** 
Name:  display_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  the  help  message  for 

the  display  function. 

Make_up:  Integer 

Source: 

Dest inat ion : 

Used  In:  help 

****************************************************************** 

****************************************************************** 
Name:  display_word 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  command  word  that  is  displayed 

to  the  user. 

Make_up:  msg_line 

Source:  * 

Dest inat ion: 

Used  In:  prompt_help 

****************************************************************** 

****************************************************************** 
Name:  disp_line 

Type:  Procedure 
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Description:  This  procedure  reads  one  line  of  text  from  the  file 

MSG. DAT  and  displays  it  on  the  assigned  device. 
Global  Variables  Used:  msg_txt 

Global  Variables  Changed:  None 

Global  Constants  Used:  as_assigned,  screenwidth 

Passed  Variables:  rec_num 

None 

HELP. SYS 
None 
None 


Returned: 

Files  Read: 
Files  Written: 
Aliases : 


Procedures  Called:  out  string 


Called  By; 


disp_msg 


Version:  1.2 

Date:  18  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  MSG. PAS 

★a**************************************************************** 

****************************************************************** 
Name:  disp_matrx 

Type:  Procedure 

Description:  This  procedure  displays  the  matrix  from  a  record  in 

'matrix.dat'  The  user  should  place  a  pause  in  his 
code  to  keep  the  display  on  the  screen. 

Global  Variables  Used:  matrix 

Global  Variables  Changed:  None 
Global  Constants  Used:  as_assigned 

Passed  Variables:  choice 

choice 
MATRIX.DAT 
None 
None 

Procedures  Called:  clear,  gotoxy,  out  string,  disp_msg, 

make_pretty_small_matrlx ,  out_real,  trim, 
make_pretty_large_matr ix_one ,  pause , 

make_pretty_large_matr ix_two 
matrxmanipl,  matrxmanip2,  mmatrix 


Returned: 

Files  Read: 
Files  Written: 
Aliases : 


Called  By: 


Version:  2.0 

Date:  20  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF  ; 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRIX. PAS 

****************************************************************** 

****************************************************************** 
Name:  disp_msg 

Type:  Procedure 


m 


i »  1  ^ 
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Description:  This  procedure  displays  the  message  pointed  to  by  the 
parameter  passed  in,  msg_num.  The  message  is  dis¬ 
played  at  the  current  cursor  position.  If  the  message 
length  is  longer  that  23  lines  the  display  stops  after 
showing  22  lines  and  waits  for  the  user  to  enter  a 
<CR>.  If  a  '$'  is  entered  the  procedure  is  exited  and 
returns  to  calling  procedure. 


Global  Variables 

Used:  msg_dir 

Global  Variables 

Changed:  None 

Global  Constants 

Used:  None 

Passed  Variables: 

msg_num 

Returned: 

None 

Files  Read: 

None 

Files  Written: 

None 

Aliases: 

None 

Procedures  Called 

l:  disp_line, 

gotoxy , 

clear , 

clear_msg , 

Called  By: 

proces  error, 

recover , 

update , 

make_pretty , 

ccopyy , 

help, 

get_real , 

get  fact, 

roots , 

gettf, 

define , 

mmatr ix , 

mmatrxmlt , 

getmat , 

matrxadd. 

modi fy , 

matrxinv, 

disptf , 

delroot , 

form. 

disppoly , 

ppoly, 

get_poly , 

disp_matr ix. 

disp, 

get_poly 

name,  get_matrx_name 

Version: 

3.1 

Date: 

23  Aug  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt 

,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MSG. PAS 


*********************************************************T*»r****** 

Name:  disp_obj 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  to  indicate  the  object  that  the 

called  routine  is  to  operate  with. 

Make_up:  cmdword 

Source: 

Destination: 

Used  In:  gettf 

****************************************************************** 


Name:  D ISP. PAS 


FILE:  DATA  DICTIONARY 
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Description:  This  file  contains  the  logic  to  display  the 

selected  DISPLAY  option  on  the  screen. 

Procedures  Contained:  disp,  disptf 
Version:  1.0 

Date:  4  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

******************************************************************* 


Name:  disppoly 

Type:  Procedure 

Description:  This  procedure  displays  the  polynomial  form  a  record 

in  ' tf&pols .dat '  The  user  should  place  a  pause  in 
his  code  to  keep  the  display  on  the  screen. 


Global  Variables  Used: 


Global  Variables  Changed:  None 


polynomial 


Global  Constants  Used: 

Passed  Variables:  choice 

Returned:  None 

Files  Read:  TF&POLS . DAT 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear,  gotoxy,  out_string,  dispjnsg, 

make_pretty,  out__real7  trim 

Called  By:  polymanip,  polymanip2,  ppoly,  inroot, 

delroot,  get_poly 


as_ass igned 


Version:  1.0 

Date:  6  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLY. PAS 


Type:  Procedure 

Description:  This  procedure  displays  the  transfer  function  from 

a  record  in  ’ tf&pols. dat ' 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  as_assigned 

Passed  Variables:  disp_obj 
Returned:  None 

Files  Read:  TF&POLS. DAT 

Files  Written:  None 

Aliases:  None 


FILE:  DATA  DICTIONARY 


D-33 


Procedures 

Called:  clear,  gotoxy, 

out_str ing , 

disp  msg 

make  pretty,  out_ 

real,  trim. 

pause 

Called  By: 

disp 

Version : 

2.0 

Date: 

25  Sep  85 

Author: 

Susan  K.  Mashiko,  Capt , 

USAF 

Gary  C.  Tarczynski,  Capt 

,  USAF 

Contained 

In  File:  DISP. PAS 

************************************************************* 
Name:  disp_row 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  row  offset  that  the  display 

of  the  numerator,  denominator,  or  polynomial  should 
be  started  on. 

Make_up:  Integer 

Source: 

Dest inat ion : 

Used  In:  gettf,  poly,  get  poly 


Name:  divisor 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  divisor  used  in  the  calculation 

of  the  inverse  of  a  matrix. 

Make_up:  Real 

Source: 

Dest inat ion : 

Used  In:  matrxinv 


Name:  dlen 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  length  of  the  dictionary. 
Make_up:  Integer  , 

Source:  get_line 

Destination: 

Used  In:  get_line 

****************************************************************** 


Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  length  of  dword 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  check_word 

*  *  *  * * * ***************************************************jr******** 

****************************************************************** 

Name :  DONEWORD 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description: 

Make_up:  Character 

Source:  Declared  in  msdwcons 

Dest inat ion : 

Used  In:  prompt_help,  val_n_dec 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★★★♦★★★★★★★★★★★★★Hr*** 

Name:  dword 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  dictionary  word  the  user  input 

is  compared  with. 

Make_up:  cmdword 

Source: 

Dest inat ion : 

Used  In:  check_word 

★★★★★★★★★★a******************************************************* 

*******★★*******★★*****★*★★★**★★★*★***★★★*******★★★*******★***★*** 

Name :  ENDCODE 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  This  unique  number  indicates  that  the  end  has  been 

reached  in  the  trace  through  the  command  syntax 
structure.  Indicates  to  prompt_help  that  no  more 
words  are  to  be  displayed  as  the  end  of  valid  objects 
for  the  previously  entered  cpmmand  words  have  been 
reached.  ? 

Make_up:  Integer 

Source:  Declared  in  msdwcons 

Dest inat ion : 

Used  In:  prompt_help,  val_n_dec 
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Name:  epsi 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  number  is  used  for 

the  delta  value  is  less 
root  is  considered  valid 
Real 


comparison  in  roots.  Once 
than  epsi  then  the  converged 


Make_up: 
Source: 
Dest inat 
Used  In: 
***★★★*★ 


ion: 

roots 


Name: 

Aliases : 

Type  Of  Entry 
Description: 


Make_up: 


Source: 
Destination : 
Used  In: 


error__code 

None 

:  Data  flow 

This  indicates  which  problem  occurred  in  the 
command  decoding  process  of  val_n_dec.  The  user 
never  sees  these  codes  per  se,  only  the  error 
messages  generated  in  response  to  them. 

Char 

A  or  a  -  no  error,  entry  value  used  as  control  for  the 
the  while  statement. 

N  or  n  -  exit  value  when  successful  validation  has 
been  accomplished. 

B  or  b  -  word  does  not  exist  in  dictionary. 

C  or  c  -  Indicates  too  many  words  in  command. 

D  or  d  -  Indicates  the  command  is  incomplete. 

get_cmd,  val_n_dec 

get_cmd,  val_n_dec,  proces_error 

***************************************************** 


Name : 

A1  iases : 
Type  Of 
Descript 

Make_up: 
Source: 
Dest inat 
Used  In: 


ff 

None 

Entry:  Global 

ion:  This  is 

charact 
Integer 
Declared  i 

ion : 


constant 

the  decimal  value  for  the  form  feed 
er . 

n  msdwcons 


*  * 


Name:  field 

Aliases:  None 

Type  Of  Entry:  Data  flow 
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Description : 


Name: 

Aliases: 

Type  Of  Entry: 
Description: 


Make_up: 
Source : 
Destination: 
Used  In: 


f ieldwidth 
None 

:  Variable 

This  number  is  passed  to  outstring  to  indicate 
how  long  the  number  to  be  output  is. 

Integer 


out  real 


Name: 
Aliases: 
Type  Of  E 
Descripti 

Make_up: 
Source : 
Dest  inat : 
Used  In: 


first 

None 

Entry:  Variable 

ion:  This  variable  is  used  to  pass  a  the  name  of  a  poly¬ 

nomial  or  transfer  function, 
cmdword 


mmatrix,  ppoly, 
matrxmanip2 


polmanip,  polmanip2, 


rra 

Type:  Procedure 

Description:  This  procedure  will  form  OLTF's  and  CLTF's 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only 

Passed  Variables:  None 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear,  gotoxy,  disp_msg,  out_sti 

pause , 


get_int,  polymlt. 


out_str  mg 
clear_msg , 
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Called  By: 


poly_f  rom_storage ,  poly_into_storage , 
highlight,  nohighlight,  spolymlt, 
polyadd,  disptf 
select  routine 


Version: 
Date: 
Author : 


1.0 

7  Aug  8  5 

Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  FORM. PAS 

***************************************************************** 


Name:  form  msg 


Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  number  is  number  of  the  message  for  help 

for  the  form  command. 

Make_up:  Integer 

Source: 

Dest inat ion: 

Used  In:  help 

****************************************************************** 


Name:  form_poly 

Type:  Procedure 

Description:  This  procedure  will  form  a  polynomial  from  the 

factored  form. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  maxdegl 

Passed  Variables:  poly 
Returned:  poly 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  poly,  inroot,  delroot 


Version:  1.0 

Date:  26  Aug  85  ? 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETTF.PAS 


Type:  File 

Description:  This  file  will  form  OLTF's  and  CLTF's 

Procedure  contained:  poly_f rom_storage ,  poly_into_storage, 

form 

Version:  1.0 

Date:  7  Aug  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 

****************************************************************** 
Name:  gain 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  storage  area  for  the  gain  of 

the  transfer  function. 

Make_up:  Real 

Source: 

Dest i nat ion : 

Used  In:  form 

****************************************************************** 

****************************************************************** 
Name:  gdpoly 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  polynomial,  the  denominator  of 

the  feedforward  transfer  function. 

Make_up:  polynomial 

Source: 

Dest inat ion : 

Used  In;  form 

****************************************************************** 

****************************************************************** 
Name:  getchi 

Type:  Function 

Description:  This  function  gets  one  character  from  a  string  and 

returns  it  to  the  read  function  for  conversion. 
Global  Variables  Used:  strng 

Global  Variables  Changed:  strng 

Global  Constants  Used:  None  ? 

Passed  Variables:  None 


Returned:  char 
Files  Read:  None 
Files  Written:  None 
Aliases:  None 


Procedures  Called:  None 
Called  By: 
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Version:  1.0 

Date:  18  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Contained  In  File:  GETINT.PAS 

****************************************************************** 

****************************************************************** 
Name:  get_cmd 

Type:  Procedure 

Description:  This  procedure  handles  all  processing  associated  with 
getting  a  valid  command  from  the  user.  It  is  called 
by  the  program  and  operation  is  maintained  here  until 
a  decoded  and  validated  command  is  entered. 

Global  Variables  Used:  help_level,  cmdbuffer,  call_rout ine , 

abort_command 

Global  Variables  Changed:  abort_command 

Global  Constants  Used:  yes 

Passed  Variables:  cmdbuffer,  call_rout ine ,  num_of_commands 

Returned:  num_of_commands 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  gotoxy,  readcom,  get_line, 

val_n_dec,  prompt_help,  displa_commandword, 

prompt_cmd,  instruction,  proces_error , 

clear 

Called  By:  icecappc 

Version:  3.1 

Date:  16  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  GETCOM.PAS 

********************************** ***********************-r******** 

★a*************************************************************** 

Name :  GETCOM . PAS 

Type:  File 

Description:  This  file  contains  the  procedures  which  handle  all 

processing  associated  with  getting  a  valid  command 
from  the  user.  It  is  called  by  the  program  and 
operation  is  maintained- here  until 
a  decoded  and  val idated ^command  is  entered. 

Procedures  Contained:  get_cmd 
Version:  3.1 

Date:  16  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

**********************************************************X******* 

****************************************************************** 


FILE:  DATA  DICTIONARY 
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Name:  get_data 

Type:  Procedure 

Description:  This  procedure  reads  the  data.dat  file  and  initial¬ 

izes  the  program  variables  passed  to  it. 

Global  Variables  Used:  blanks,  call_rout ine ,  status_line, 

msg_dir,  decode_dict,  printer, 

trans,  temp,  crt, 

show_abbreviation,  in_terminal, 

stat_on,  macro_error,  help_level, 

list_dev_name,  trans_f ile_name, 
macro_f i le_name 

Global  Variables  Changed:  same  as  global  variables 

Global  Constants  Used:  term_length,  screen_width,  num_words, 

printer_length,  num_msg_dir,  num_ptrs 

Passed  Variables:  term_dat,  print_dat,  msg_dir,  printer, 

decode_dict,  trans,  temp,  crt,  stat_on, 

show_abbreviation ,  in_terminal,  macro_error, 
help_level,  list_dev_name,  trans_f ile_name, 
macro_f i le_name 

Returned:  all  passed  variables  are  changed  except 

term_dat  and  print_dat 

Files  Written:  printer. out,  transact. ion,  macro. inp, 

temp. out 

Files  Read:  help.sys,  microvsdv.sys 

Aliases:  None 

Procedures  Called:  clear,  title_slide,  bld_stat_line. 

Called  By:  icecappc 


Version:  4.0 

Date:  22  Jul  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETDAT.PAS 


Name:  GETDAT.PAS 

Type:  File 

Description:  This  file  reads  the  data  file  from  the  disk  and  inserts 

it  into  the  appropriate  tables  in  the  main  program.  It 
also  initializes  the  flags  and  help_level  and  displays 
the  titleslide. 

Procedures  Contained:  title_slide,  bld_stat_line,  get_data 

Version:  4.0 

Date:  22  Jul  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
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Name:  get_fact 

Type:  Procedure 

Description:  This  procedure  gets  the  factored  form  of  the  poly¬ 
nomial  . 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 
Global  Constants  Used:  as_assigned 


Passed  Variables: 

poly. 

row, 

abort_command 

Returned: 

poly 

Files  Read: 

None 

Files  Written: 

None 

Aliases: 

None 

Procedures  Called: 

make_pretty , 

get_r_num, 

gotoxy , 

out_real , 

d i sp_msg , 

pause. 

clear  msg 

Called  By: 

poly 

Version:  2.2 

Date:  8  Sep  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETTF.PAS 


Name:  GET I NT. PAS 

Type:  File 

Description:  This  file  handles  the  input  of  integers.  Normal 

program  integer  input  does  not  have  edit  capabilities 
to  exclude  inputs  such  as  letters.  This  procedure  only 
accepts  valid  input. 

Procedures  Contained:  del_lst_ch,  ck_chr,  out_int, 

get_int,  get_chi 

Version:  1.3 

Date:  18  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 


Name:  get_int 

Type:  Procedure 

Description:  This  procedure  handles  the  input  of  integers.  Normal 

program  integer  input  does  not  have  edit  capabilities 
to  exclude  inputs  such  as  letters.  This  procedure  only 
accepts  valid  input. 
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Global  Variables  Used: 
Global  Variables  Changed: 
Global  Constants  Used: 
Passed  Variables:  number. 
Returned: 

Files  Read: 

Files  Written: 

Aliases: 

Procedures  Called: 

Called  By: 


number, 

None 

None 

None 

get_strng 
gettf,  getmat, 
get_poly 


strng,  abort_command 
strng,  abort_command 
as_assigned 

abort_command 
abort  command 


chgmat,  delroot,  form, 


Version:  1.3 

Date:  18  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  GET I NT . PAS 

a***************************************************************** 


★a**************************************************************** 
Name:  GETLINE . PAS 

Type:  File 

Description:  This  procedure  builds  a  decoded  entry  from  the  record 
pointed  to  on  entry.  The  pointers  come  from  the  ptrs 
part  of  dict_buffer  and  the  word  comes  from  the  words 
part  of  the  dict_buffer. 

Procedures  Contained:  get_line 
Version:  3.0 

Date:  17  Jul  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

***************************************************************** 


****************************************************************** 
Name:  get_line 

Type:  Procedure 

Description:  This  procedure  builds  a  decoded  entry  from  the  record 
pointed  to  on  entry.  The  pointers  come  from  the  ptrs 
part  of  dict_buffer  and  the  word  comes  fro  the  words 
part  of  the  dict_buffer. 

Global  Variables  Used:  blanks 

Global  Variables  Changed:  None 

Global  Constants  Used:  wordsize,  word_length 

Passed  Variables:  decode,  ?  rec_num 

None 

dict_file 
None 
None 
None 

get_cmd,  prompt_help,  val_n_dec 


Returned: 

Files  Read: 

Files  Written: 
Aliases : 

Procedures  Called: 
Called  By: 
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Version:  3.0 

Date:  17  Jul  83 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Contained  In  File:  GETLINE.PAS 

********* ****★★★****★ * 


****************** 

Name:  get_location 

Type:  Procedure 

Description:  This  procedure  determines  the  record  location  of  the 
source  and  destination  objects  for  the  copy  function. 
Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 


Passed  Variables: 
Returned: 

Files  Read: 

Files  Written: 
Aliases : 

Procedures  Called: 
Called  By: 


location , 

rec_loc , 

None 

None 

None 

None 

ccopyy 


rec_loc , 
type  move 


type_move 


Version:  2.0 

Date:  4  Sep  85 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  COPY. PAS 


Name:  getmat 

Type:  Procedure 

Description:  This  procedure  will  get  a  r 
Global  Variables  Used:  matrix,  ab( 

Global  Variables  Changed:  matrix 
Global  Constants  Used:  as_assigned, 

crt_only 

Passed  Variables:  def_obj 
Returned:  None 

Files  Read:  MATRIX . DAT 

Files  Written:  None  : 

Aliases:  None 

Procedures  Called:  out_string,  pause, 

gotoxy,  get_int, 

disp  msg,  clear  m: 


a  matrix  and  store 
abort_command 

,  max  cols,  max 


Called  By: 


disp_msg,  clear_msg, 

make_pretty_large_matr ix_one 
make_pret ty_smal l_mat  r i x 
define 


clear, 

get  matrix  entries, 


FILE:  DATA  DICTIONARY 


Version:  1.0 

Date:  11  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C,  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETMAT . PAS 

****************************************************************** 


****************************************************************** 
Name:  get_matrix_entr ies 

Type:  Procedure 

Description:  This  procedure  will  get  a  matrix  entry. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 

None 

abort  command 


Global  Constants  Used: 


Passed  Variables: 
Returned: 

Files  Read: 

Files  Written: 
Aliases : 

Procedures  Called: 
Called  By: 


matrix , 
matrix 
None 
None 
None 

get_r_num,  pause,  clear, 
make_pretty_large_matr ix_two 
getmat 


Version:  1.0 

Date:  11  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETMAT. PAS 

****************************************************************** 


****************************************************************** 
Name:  get_matrx_name 

Type:  Procedure 

Description:  This  procedure  will  get  the  name  of  a  matrix  from 
the  screen. 

Global  Variables  Used:  blanks,  abort_command 

Global  Variables  Changed:  blanks 


Global  Constants 

Used:  as 

assigned,  crt 

_only 

Passed  Variables: 

mat  name, 

row,  col, 

abort  command 

Returned: 

None 

Files  Read: 

None 

Files  Written: 

None  ; 

Aliases : 

None 

Procedures  Called 

:  highlight, 

nohighlight , 

gotoxy , 

out_str ing , 

ucase. 

clear  msg. 

get_strng , 

disp_msg. 

pause 

Called  By: 

mmatr ix 

Version:  1.0 
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Date: 
Author : 


20  Sep  85 

Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MMATRIX.PAS 

****************************************************************** 

****************************************************************** 
Name :  GETMAT . PAS 

Type:  File 

Description:  This  file  contains  the  procedure  that  will  get  a 

matrix  and  store  it. 

Procedures  Contained:  lef t_bracket ,  r ight_bracket ,  get_mat, 

make_pretty_large_matr ix_one, 
make_pretty_large_matr ix_two, 

make_pretty_small_matr ix,  get_matrx_entr ies. 

Version:  1.0 

Date:  12  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

A***************************************************************** 

a***************************************************************** 

Name:  get_poly 

Type:  Procedure 

Description:  This  procedure  will  get  a  polynomial  in  either  the 

factored  or  the  poly  form. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 

Global  Constants  Used:  as_assigned,  crt_only 

Passed  Variables:  def_obj ,  method 

Returned:  None 

Files  Read:  None 

Files  Written:  TF&POLS.DAT 

Aliases:  None 

Procedures  Called:  clear,  gotoxy,  disp_msg,  out_string, 

get  int,  disppoly,  trim,  pause 

Called  By:  define 

Version:  1.0 

Date:  28  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  DEFINE. PAS 

♦a**************************************************************** 


Name:  get_poly_name 

Type:  Procedure 

Description:  This  procedure  will  get  the  name  of  a  polynomial  form 
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che  screen. 

Global  Variables  Used:  blanks,  abort_command 

Global  Variables  Changed:  None 

Global  Constants  Used:  as_assigned,  crt_only 

Passed  Variables:  poly_name,  row,  col,  abort_command 
Returned:  poly_name 

Files  Read:  None  - 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  highlight,  nohighlight,  gotoxy,  out_string 

ucase,  trim,  pause, 

get_strng,  disp_msg,  clear_msg 

Called  By:  ppoly 

Version:  1.0 

Date:  6  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLY. PAS 

****************************************************************** 


****************************************************************** 
Name:  get_real 

Type:  Procedure 

Description:  This  procedure  gets  a  real  number  from  the  user.  The 

procedure  checks  the  validity  of  the  input  number. 
This  prevents  in  inadvertant  exit  to  the  operating 
system. 

Global  Variables  Used:  abort_command,  strng 

Global  Variables  Changed:  abort_command,  strng 

Global  Constants  Used:  as_assigned 

Passed  variables:  number,  abort_command 

Returned:  number 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  get__string,  gotoxy,  pause, 

disp_msg,  clear_msg,  highlight, 

out_string,  nohighlight 

Called  By:  get_r_num 

Version:  L.  0 

Date:  19  Aug  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  REALS. PAS 

****************************************************************** 

****************************************************************** 
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Name:  get_r_num 

Type:  Procedure 

Description:  This  procedure  gets  a  real  number  from  the  user.  The 

procedure  checks  the  validity  of  the  input  number. 
This  prevents  in  inadvertant  exit  to  the  operating 
system.  Additionally  this  procedure  will  provide  a 
prompt  on  row  20,  and  will  provide  an  error • message 
is  there  is  something  wrong  with  the  input.  The  user 
must  pass  the  row  and  the  col  of  the  desired  location 
of  the  real  number. 

Global  Variables  Used:  blanks,  abort_command 

Global  Variables  Changed:  blanks 

Global  Constants  Used:  as_assigned,  crt_only 

Passed  Variables:  number,  abort_command,  row,  col 

Returned:  number 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  out_real,  gotoxy, 

highlight,  get  real, 

out_string,  nohTghiight, 

Called  By:  get_fact,  get_unfact,  mmatrix, 

get_matrx_entr ies ,  chgmat,  inroot 

Version:  1.2 

Date:  20  Aug  85 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETTF.PAS 

****************************************************************** 

****************************************************************** 
Name:  GETSTRIN.PAS 

Type:  File 

Description:  This  file  gets  the  ASCII  input  from  terminal 

keyboard  or  the  macro  command  file  as  specified  in 
the  input  parameter.  Collects  characters  until  a 
<CR> . 

Procedures  Contained:  get_strng 
Version:  2.0 

Date:  ;  28  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

****************************************************************** 

****************************************************************** 
Name:  get_strng 

Type:  Procedure 

Description:  This  procedure  gets  the  ASCII  input  from  terminal 
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keyboard  or  the  macro  command  file  as  specified  in 
the  input  parameter.  Collects  characters  unitl  a 
<CR> . 

Global  Variables  Used:  in_terminal,  macro_file,  strng, 

abort_command 

Global  Variables  Changed:  strng,  abort_command 
Global  Constants  Used:  screen_vidth,  abort_str  ; 

Passed  Variables:  strng,  abort_command,  in_dev, 

chrl,  chr2 

Returned:  strng,  abort_command 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  get_int,  readcom,  recover, 

update,  get_real,  chgmat, 

get_poly_name ,  get_matrx_name 

Version:  2.0 

Date:  28  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  GETSTRIN.PAS 

***************************************************************** 

***************************************************************** 
Name:  gettf 

Type:  Procedure 

Description:  This  procedure  gets  the  transfer  function  in  either 
polynomial  or  factored  form. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  abort_command 

Global  Constants  Used:  crt_only,  as_assigned,  maxdeg 


Passed  Variables: 

def_obj ,  method 

Returned: 

None 

Files  Read: 

TF&POLS . DAT 

Files  Written: 

None 

Aliases : 

None 

Procedures  Called: 

clear,  gotoxy, 

disp_msg , 

out  string,  get  int. 

clear  msg 

trim,  poly, 

disptf , 

pause 

Called  By:  : 

define 

Version: 

3.0 

Date: 

25  Sep  85 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  uapt,  USAF 
Contained  In  File:  GETTF. PAS 
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****************************************************************** 
Name:  GETTF.PAS 

Type:  File 

Description:  This  file  gets  the  transfer  function  in  either 
polynomial  or  factored  form. 

Procedures  Contained:  get_r_num,  make_pretty,  get_fact, 

form_poly,  roots,  get_unfact, 

poly,  gettf 

Version:  3.0 

Date:  25  Sep  85 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 


****************************************************************** 
Name:  get_unfact 

Type:  Procedure 

Description:  This  procedure  gets  the  unfactored  form  of  the  poly¬ 
nomial. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 
Global  Constants  Used:  as_assigned 


Passed  Variables: 

poly, 

row, 

abort_command 

Returned: 

poly 

Files  Read: 

None 

Files  Written: 

None 

Aliases: 

None 

Procedures  Called: 

make_pretty , 

get_r_num, 

gotoxy , 

out_real , 

disp_msg , 

pause , 

clear  msg 

Called  By: 

poly 

Version:  2.0 

Date:  25  Sep  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In? File:  GETTF.PAS 

*****************************************************+  *********** 


****************************************************************** 

Name:  gnpol 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Variable  is  a  polynomial,  numerator  of  the  feed 
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L  ‘  *_*■  »'  *'• 


Make_up: 
Source : 
Destination: 
Used  In: 


Name:  gotoxy 

Type:  Procedure 

Description:  This  procedure  places  the  cursor  at  the  x  and  y 

coordinates  passed  to  it.  It  is  capable  of  ending 
an  initial  string  of  characters  either  the  r  w  or 
column  then  an  intermediate  string  of  char,  the 
other  address  and  finally  a  trailing  string  of  char 
if  required.  Offsets  if  any  are  added  prior  to  sendi 
the  row/col 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 

Global  Constants  Used:  term__length 

Passed  Variables:  row  :  integer;  col  :  integer 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  ttype 

Called  By:  clear,  rectangle,  pause, 

title_slide,  disp_msg,  prompt_help, 

prompt_cmd,  proces_error ,  get_cmd, 

get_real  get_r_num,  recover, 

update,  ccopyy,  makepretty, 

roots,  gettf,  get_fact, 

get_unfact,  lef t_bracket ,  r ight_bracket 

getmat,  matrxadd,  mmatrxmlt, 

matrxinv,  disptf,  chgmat, 

disppoly,  inroot,  delroot, 

form,  disp_matrx,  mmatrix, 

polymlt,  get_poly_name ,  ppoly, 

get_poly ,  make_pretty_small_matr ix , 

make_pretty_large_matr ix_one, 
get_mat rx_name 


Version:  2.0 

Date:  21  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Modifier:  Paul  A.  Moore,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

a***************************************************************** 
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Name:  graphics 

Type:  Procedure 

Description:  Thi 

Global  Variables 
Global  Variables 
Global  Constants 
Passed  Variables: 
Returned: 

Files  Read: 

Files  Written: 
Aliases : 

Procedures  Called 
Called  By: 


s  procedure  places  the  terminal  in 
Used:  term 

Changed:  None 

Used:  term_length  ; 

None 
None 
None 
None 
None 

rectangle,  make_pretty,  left 
r ight_bracket 


graphics  mode. 


bracket , 


Version:  2.0 

Date:  21  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 


********************************************************* ********* 

Name:  hdpol 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Variable  is  a  polynomial,  denominator  of  the  feedback 

transfer  function. 

Make_up:  Polynomial 

Source : 

Dest inat ion : 

Used  In:  form 

****************************************************************** 


*********************************************************>t******** 

Name:  height 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Variable  is  the  desired  height  in  rows  of  the 

rectangle . 

Make_up:  Integer 

Source : 

Destination: 

Used  In:  rectangle 

****************************************************************** 

****************************************************************** 
Name:  help 

Type:  Procedure 
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Description:  This  procedure  handles  the  logic  for  providing  on 

line  help.  The  valid  command  is  scanned  to  determine 
what  help  is  requested.  The  display  message  routine  is 
then  called  with  the  correct  number  of  the  message 
desired. 

Global  Variables  Used:  cmdbuffer 

Global  Variables  Changed:  None  ; 

Global  Constants  Used:  wordsize,  buffersize 

Passed  Variables:  cmdbuffer,  wordnumber 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  pause,  clear,  disp_msg,  trim. 

Called  By:  select_routine 

Version:  2.0 

Date:  18  Sep  85 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  HELP. PAS 


****************************************************************** 
Name:  help 

Aliases:  None 

Type  Of  Entry:  Char 

Description:  Variable  that  is  used  to  insert  in  the  status  line, 

it  indicates  the  help  level  of  the  system. 

Make_up:  Char 

Source:  bld_stat_l ine 

Destination: 

Used  In:  bid  stat  line 


Name:  help_level 

Aliases:  None 

Type  Of  Entry:  Global  file  variable  and  data  flow 

Description:  Variable  indicates  the  amount  of  help  the  user  wants 

in  the  operation  of  the  program. 

Make_up:  Integer 

Source:  Declared  in  icecappc 

Dest inat ion : 

Used  In:  icecappc,  bld_stat_l ine ,  get_cmd, 

proces  error,  get  data 


Name:  help_obj 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  object  of  the  command  help.  It 

is  passed  to  other  procedur.es. 

Make_up:  cmdword 

Source: 

Destination: 

Used  In:  help 


****************************************************************** 
Name :  HELP . PAS 

Type:  File 

Description:  This  file  handles  the  logic  for  providing  on 

line  help.  The  valid  command  is  scanned  to  determine 
what  help  is  requested.  The  display  message  routine  is 
then  called  with  the  correct  number  of  the  message 
desired. 

Procedure  Contained:  help 

Version:  2.0 

Date:  18  Sep  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 


Name :  HELP . SYS 

Type  :  Data 

Description:  This  file  is  created  by  the  program  builddat,  and  is 

in  turn  used  by  the  procedure  get_data  for  initial¬ 
ization. 

Used  In:  get_data 


****************************************************************** 

Name:  highlight 

Type:  Procedure 

Description:  This  procedure  places  the  terminal  in  reverse  video 
;  mode . 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 
Global  Constants  Used:  term_length 

Passed  Variables:  None 
Returned:  None 

Files  Read:  None 

Files  Written:  None 
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Aliases: 

Procedures  Called: 
Called  By: 


None 

highlight , 
proces_error , 
get_real , 
polymlt, 
get_matrx_name 


title_slide, 
get_r_num, 
roots , 
form,  , 


prompt_cmd 
ccopyy , 
delroot , 
get_poly_name, 


Version:  2.0 

Date:  21  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 


a***************************************************************** 

Name:  hnpol 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Variable  is  a  polynomial,  the  numerator  of  the  feed 

back  transfer  function. 

Make_up:  Polynomial 

Source: 

Destination: 

Used  In:  form 

iticiciticiticit'kic-kit-kit'kic'kii'kltiticit'k'kit’kit’kit'kltit'k'kit’kit-k’klcitit'k-kie'k'kltltlc'kititlticicitieicitic-k'kic-k 


****************************************************************** 


Name:  i 

Aliases:  None 

Type  Of  Entry: 
Description: 
Make_up : 

Source: 
Destination: 
Used  In: 


Variable 

This  variable  is  used  as  a  counter. 
Integer 

Same  as  the  procedure  that  uses  it 


ucase, 

gotoxy , 

graphics , 

clear , 

nographics , 

clearscreen , 

highlight , 

nohighlight , 

videolow. 

svideolow, 

videobold. 

svideobold, 

rectangle , 

disp_msg , 

clear  msg. 

trim. 

readcom. 

check_word, 

get  cmd, 

get_data. 

recover , 

ccopyy, 

make_pretty , 

update , 

move  tf, 

move_poly , 

move_matrix, 

get_real , 

gettf , 

get_fact , 

get  unfact. 

roots , 

lef t_bracket , 

matrxsub. 

r ight_bracket , 

get_matrx_entr ies 

getmat , 

matrxadd. 

mmatrxmlt , 

polymanip, 

polymanip2 , 

dispmatrx , 

matrxmanipl , 

polysub. 

smatrxmlt , 
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matrxmanip2 ,  matrxtran,  matrxinv, 

disppoly,  get_poly,  disptf, 

chgmat,  inroot,  delroot, 

spolymlt,  polymlt,  polyadd, 

make_pretty_smal l_matr ix ,  select_rout ine , 

make_pretty_large_matr,ix_one,  proces_error 


★★★★★★★★♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★Hr********************** 


****************************************************************** 
Name:  icecappc 

Type:  Main  program 

Description:  This  file  contains  the  main  program  for  the  MICROSDW  men 
system  and  the  icecappc  subroutines.  There  are  four 
different  versions:  IBM-PC,  IBM  with  hard  drive,  Z-100, 
Z-100  with  hard  drive. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  None 
Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  get_cmd,  get_data,  select_routine 

(IBM  version  -  standard_output ) 

Called  By:  N/A 


Version: 

Date: 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  ICECAPPC. PAS 


Name:  imag_root 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  the  temporary  storage  area 

for  the  imaginary  root. 

Make_up:  Real 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 


****************************************************************** 
Name:  in_dev 

Aliases:  None 
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Type  Of 
Descript 

Make_up: 
Source: 
Destinat 
Used  In: 
******** 


Entry:  Variable  and  data  flow 

ion:  This  parameter  indicates  to  get_strng  which  device 

is  to  be  used  for  input, 
char 

get_strng 

ion: 

get_strng  1 

********************************************************** 


****************************************************************** 
Name:  inroot 

Type:  Procedure 

Description:  This  procedure  will  insert  a  root  into  a  polynomial. 

If  the  root  is  complex  the  conjugate  will  also  be 
inserted. 

Global  Variables  Used:  cmdbuffer,  abort_command 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only,  as_assigned 

Passed  Variables:  cmdbuffer,  wordnumber 

None 

TF& POLS. DAT 
TF&POLS . DAT 
None 

Procedures  Called:  clear,  gotoxy,  disppoly,  trim, 

out_real,  out_string,  get_r_num,  out_int, 
form_poly,  pause 
modify 


Returned: 

Files  Read: 
Files  Written: 
Aliases: 


Called  By: 


Version:  2.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  INROOT. PAS 

****************************************************************** 


****************************************************************** 
Name:  INROOT. PAS 

Type:  File 

Description:  This  file  will  insert  a  root  into  a  polynomial. 

If  the  root  is  complex  the  conjugate  will  also  be 
inserted. 

Procedures  Contained:  inroot 

Version:  2.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 
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Maine:  instr_col 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  constant  is  the  column  location  where  instruc¬ 

tions  for  command  entry  begins. 

Make_up:  Integer 

Source:  get_cmd  ; 

Destination:  instruction 

Used  In:  get_cmd,  instruction 

****************************************************************** 

a***************************************************************** 

Name:  instr_row 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  constant  is  the  row  location  where  instruc¬ 

tions  for  command  entry  begins. 

Make_up:  Integer 

Source:  get_cmd 

Destination:  instruction 

Used  In:  get_cmd,  instruction 

****************************************************************** 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★A***************** ******* 

Name:  instring 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  a  string. 

Make_up:  msg_line 

Source:  ucase 

Destination: 

Used  In:  ucase,  svideobold,  svideolow 

****************************************************************** 

****************************************************************** 
Name:  instruction 

Type:  Procedure 

Description:  This  procedure  issues  the  appropriate  instructions 
for  entering  a  command  based  on  the  number  of 
command  words  already  entered. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  level,  instr_row,  instr_col 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  out_string 
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Called  By: 


get_cmd 


Version:  1.1 

Date:  16  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  INSTRUCTS 

★A****************************!************************************ 

****************************************************************** 
Name:  INSTRUC.PAS 

Type:  File 

Description:  This  file  issues  the  appropriate  instructions 
for  entering  a  command  based  on  the  number  of 
command  words  already  entered. 

Procedures  Contained:  instruction 
Version:  1.1 

Date:  16  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

****************************************************************** 

**********************************************************  ******** 
Name:  in_terminal 

Aliases:  None 

Type  Of  Entry:  Global  variable  and  data  flow 

Description:  This  variable  indicates  whether  the  input  should  come 

from  the  terminal  keyboard  or  the  macrofile. 

Makeup:  Boolean 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  get_strng,  getdata 


****************************************************************** 

Name:  iteration 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  counter  for  the  number  of 

iterations  the  procedure  roots  goes  thru  before  the 
root  is  found. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 

****************************************************************** 

Name:  j 

Aliases:  None 

Type  Of  Entry:  Variable 
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Description:  Generally  set  up  as  a  counter. 

Make_up:  integer 

Source: 

Destination: 

Used  In:  prompt_help,  readcom,  matrxadd,  matrxsub, 

get_matr ix_e/itr ies ,  sraatrxmlt,  mmatrxmlt, 
matrxinv,  miatrxinv,  matrxtran,  chgmat, 
polymlt 

**********************  M ******************************************* 

**********************************x******************************* 

Name:  k 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Generally  set  up  as  a  counter. 

Make_up:  integer 

Source: 

Destination: 

Used  In:  roots 

★a**************************************************************** 

****************************************************************** 

Name:  1 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  mmatrxmlt 

****************************************************************** 

****************************************************************** 

Name:  LI 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  line  +  height  -  1 

Make_up:  integer 

Source:  rectangle 

Destination: 

Used  In:  rectangle 

****************************************************************** 

****************************************************************** 

Name:  last_rec_num 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  the  last  record  in 

the  file. 


FILE:  DATA  DICTIONARY 


D-60 


Make_up:  Integer 

Source: 

Destination: 

Used  In:  val_n_dec 

****************************************************************** 

4 

****************************************************************** 
Name:  left_bracket 

Type:  Procedure 

Description:  This  procedure  draws  the  left  bracket  around  a  matrix 
displayed  oh  the  terminal. 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  num_rows 
Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Porcedures  called:  graphics,  gotoxy,  nographics 

Called  by:  make_pretty_small_matr ix ,  make_pretty_large_matr ix_one 

make_pretty_large_matrix_two 

Version:  1.0 

Date:  11  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETMAT . PAS 

****************************************************************** 

****************************************************************** 

Name:  lencmd 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  length  of  the  command  line  that 

was  input  by  the  user. 

Make_up:  Integer 

Source:  readcom 

Destination: 

Used  In:  readcom 

****************************************************************** 

****************************************************************** 

Name:  length 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  length  of  the  message  to  be 

displayed  or  erased. 

Make_up:  Integer 
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Source: 

Destination: 

Used  In:  disp  msg,  clear_msg 

****************************************************************** 

****************************************************************** 
Name:  level 

Aliases:  None 

Type  Of  Entry:  Variable  and  data  flow 

Description:  This  variable  indicates  which  iteration  through  the 

recursive  val_n  dec  procedure  a  fault  occured.  Thus 
it  indicates  which  word  in  the  command  buffer  is 
causing  problems  and  allows  prompts  based  on  that 
word/position. 

Makeup:  Integer 

Source:  get_cmd,  val_n_dec 

Destination: 

Used  In:  get_cmd,  instruction,  val_n_dec 

proces_error 

****************************************************************** 

****************************************************************** 

Name:  line 

Aliases:  None 

Type  of  Entry:  Variable 

Description:  This  variable  indicates  which  row  should  be  the  top 

of  the  rectangle. 

Makeup:  Integer 

Source: 

Destination: 

Used  In:  retangle 

****************************************************************** 

****************************************************************** 
Name:  list_dev 

Aliases:  None 

Type  Of  Entry:  Global  file  variable 

Description:  Logical  file  -  when  output  is  to  this  'fils'  the 

output  is  written  to  a  file  ’ PRINTER. OUT ' 

Make_up:  TEXT 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  get  data,  out_string,  out_int 

****************************************************************** 

****************************************************************** 
Name:  1 ist_dev_name 

Aliases:  None 

Type  Of  Entry:  Global  file  variable 
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Description:  This  variable  is  not  used  in  icecappc 

Make_up: 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  get_data 

****************************************************************** 

****************************************************************** 

Name:  location 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  passed  internal  to  the  file  Copy. 

It  is  the  object  that  is  to  be  copied. 

Make_up:  cmdword 

Source: 

Destination: 

Used  In:  get_location 

************************************************************X1***** 

****************************************************************** 

Name:  logo 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  constant  is  word  or  phrase  printed  on  the  CRT 

to  prompt  the  user  for  a  command. 

Makeup:  Char 

Source: 

Destination: 

Used  In:  prompt_cmd 

*  a**************************************************************** 

****************************************************************** 

Name:  m 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Generally  set  up  as  a  counter. 

Make_up:  integer 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 

****************************************************************** 
Name:  macro_error 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  This  variable  is  the  flag  that  indicates  whether 

an  error  has  occured  while  getting  input  from  the 
macro  command  file. 
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Boolean 

Declared  in  icecappc 


Make_up: 

Source: 

Destination: 

Used  In:  icecappc,  readcom,  get_data 

****************************************************************** 

****************  ★**  ************************************************ 
Name:  macro_file 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  File  of  text  that  contains  the  commands  and  data 

input  as  macro  commands  for  non-interactive  program 
use . 

Make_up:  Text 

Source:  Declared  in  icecappc 

Destination: 

Ured  In:  get_data,  get_strng 

****************************************************************** 


****************************************************************** 


Name: 

Aliases: 

Type  Of  Entry 
Description: 


Make_up: 
Source: 
Destination: 
Used  In: 


macro_f i le_name 
None 

:  Global  variable 

The  name  of  the  text  file  that  contai 
and  data  input  as  macro  commands  for 
program  use. 

Paramstr ing 
Declared  in  icecappc 

icecappc,  get_data 


ns  the  commands 
non- interactive 


****************************************************************** 
Name:  MACRO. I NP 

Type:  Text 

Description:  This  file  contains  the  command  and  the  data  inout  for 
the  non_interact ive  mode  of  ICECAP-PC. 

Used  In:  get_data 

****************************************************************** 


****************************************************************** 
Name:  make_pretty 

Type:  Procedure 

Description:  This  procedure  pretties  up  the  screen  for  transfer 

function  input. 

Global  Variables  Used:  term,  degree 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only,  screen_width,  as_assigned 

Passed  Variables:  row,  degree 
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Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  gotoxy,  disp_msg,  graphics, 

,  put_string,  out_int 

Called  By:  ;  get_fact,  get_unfact,  disptf, 

Version:  2.3 

Date:  26  Aug  85 

Author:  Vincent  M  Par is i  II,  Capt ,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

Contained  In  File:  GETTF.PAS 

****************************************************************** 

**************************************************?ir*************** 

Name:  make_pretty_large_matr ix_one 

Type:  Procedure 

Description:  This  procedure  will  draw  the  left  bracket  and  place 
row  and  col  numbers  on  the  first  display  screen  of 
a  matrix  with  more  than  5  cols. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only,  as_assigned 

Passed  Variables:  num_row,  num_col 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  gotoxy,  out_string,  out_int, 

left_bracket 

Called  By:  getmat,  dispjnatrx,  chgmat,  get  matr ix_entr ies 

Version:  1.0 

Date:  11  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETMAT. PAS 

****************************************************************** 

****************************************************************** 
Name:  make_pretty_large_matr ix_two 

Type:  Procedure 

Description:  This  procedure  will  draw  the  right  bracket  of  a 

matrix  with  more  than  5  columns.  It  will  also  write 
the  col  and  row  identifiers  on  the  screen. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 


nographics , 
disppoly 
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Global  Constants  Used:  crt_only,  as_assigned 

Passed  Variables:  num_row,  num_col 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  ,  None 

Procedures  Called:  gotoxy,  out_string,  out_int, 

lef t_bracket 

Called  By:  getmat,  disp_matrx,  chgmat,  get_matr ix_entr ies 


Version:  '  1.0 

Date:  11  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETMAT. PAS 

****************************************************************** 


****************************************************************** 
Name:  make_pretty_small_matr ix 

Type:  Procedure 

Description:  This  procedure  will  draw  the  brackets  and  label  the 
cols  and  rows  for  a  matrix  with  5  cols  or  less. 
Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only,  as_assigned 

Passed  Variables:  num_row,  num_col 
Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  gotoxy, 


Called  By: 


out_string,  out_int, 
lef t_bracket ,  r ight_bracket 
getmat,  disp_matrx,  chgmat 


Version:  1.0 

Date:  11  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETMAT. PAS 

****************************************************************** 


****************************************************************** 

Name:  mat 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  matrix. 

Make_up:  matrix 

Source : 

Destination: 
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Used  In:  recover,  update,  chgmat,  disp_matrx 

****************************************************************** 

Name:  matl 

Aliases:  .  None 
Type  Of  Entry:  Variable 

Description:  This  is  a  temporary  matrix  that  is  used  to  pass 

matrices  between  procedures. 

Make_up:  matrix 

Source: 

Destination: 

Used  In:  matrxmanipl,  matrxmanip2 

★★a*************************************************************** 

****************************************************************** 

Name:  mat 2 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  temporary  matrix  that  is  used  to  pass 

matrices  between  procedures. 

Make_up:  matrix 

Source: 

Destination: 

Used  In:  matrxmanipl,  matrxmanip2 

****************************************************************** 

****************************************************************** 

Name:  mat3 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  temporary  matrix  that  is  used  to  pass 

matrices  between  procedures. 

Make_up:  matrix 

Source: 

Destination: 

Used  In:  matrxmanipl 

leicicicicfclt^icit’kicit’kicicicicieitieititieit'kifieit’kieititit'k'kieicic'kiticieic'k'k’k'k’k’kit-k’kicifie'kit'k-k’k’k’kieitic 

**************x**********************^**************************** 

Name:  mat a 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  file  of  matrix. 

Make_up:  file  of  matrix 

Source: 

Destination: 

Used  In:  recover,  update 

*********************************************************Tlr******** 
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****************************************************************** 

Name:  mat_file 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  file  of  matrix. 

Make_uR:  file  of  matrix 

Sourced 

Destination: 

Used  In:  move_matrix 

****************************************************************** 

****************************************************************** 

Name:  mat_name 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  the  matrix  name. 

Make_up:  msg_line 

Source: 

Destination: 

Used  In:  mmatrix 

*****************************  ******************************  ******* 

**************************** **************************1'*** ******** 

Name:  mat_obj 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  to  indicate  the  object  that 

the  called  routine  is  to  operate  with. 

Make_up:  cmdword 

Source: 

Destination: 

Used  In:  matrxmanip2,  mmatrix 

****************************************************************** 

****************************************************************** 

Name:  matrices 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  file  of  matrix. 

Make_up:  msg_line 

Source: 

Dest inat ion : 

Used  In:  getmat 

****************************************************************** 

****************************************************************** 
Name:  matrix 

Aliases:  None 

Type  Of  Entry:  Type  definition 
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This  is  the  record  definition  for  a  file  of  matrix, 
matrix  =  record 

num_rows  :  integer; 
num_cols  :  integer; 

element  ;  array[  l..max_rows,  l..mac_cols  ] 
of  real; 

end; 

Declared  in  concons 

recover,  update,  move_matrix, 

matrxmanipl,  matrxmanip2,  disp_matrx 
matrxtran,  matrxinv,  chgmat, 

get_matrx_entr ies ,  matrxsub,  smatrxmlt, 
getmat,  matrxadd,  mmatrxmlt 

****************************************************************** 

****************************************************************** 
Name:  MATRIX. PAS 

Type:  File 

Description:  This  file  will  decode  the  command  string  from 

define. pas  and  call  the  appropriate  procedures. 
Procedures  Contained:  disp_matrx,  matrx_manipl ,  matrx_manip2 , 

get_matrx_name ,  mmatrix 

Version:  1.0 

Date:  22  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 

****************************************************************** 

Name:  matrx 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  matrix. 

Make_up:  matrix 

Source: 

Destination: 

Used  In:  move_matrix 

****************************************************************** 

****************************************************************** 
Name :  MATRXMAN . PAS 

Type:  File 

Description:  This  file  contains  the  matrix  manipulation  procedures 
Procedures  Contained:  matrxadd,  mmatrxmlt,  matrxsub, 

smatrxsub,  matrxtran,  matrxinv 

Version:  1.0 

Date:  22  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 


Description: 
Make_up : 


Source: 
Destination: 
Used  In: 
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-  •  w  *_w  -*■ 


Gary  C.  Tarczynski,  Capt ,  USAF 


*********************************************************-********* 
Name:  matrxadd 

Type:  Procedure 

Description:  This  procedure  will  add  two  matrices  together  and 
store  the  result  in  the  third  matrix  passed  to 
the  procedure. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  abort_command 

None 

bmat,  cmat,  abort_command 
abort  command 


Global  Constants  Used: 
Passed  Variables:  amat, 
Returned:  cmat, 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear, 


Called  By: 


gotoxy,  pause,  disp  msg 


matrxsub,  matrxmanipl 


Version: 

Date: 

Author: 


1.0 

18  Sep  85 

Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRXMAN . PAS 

a***************************************************************** 


****************************************************************** 
Name:  matrxinv 

Type:  Procedure 

Description:  This  procedure  will  invert  a  matrix  and  place  the 
result  in  the  second  matrix  passed  to  it. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 

None 

bmat,  abort_command 
bmat,  abort  command 


Global  Constants  Used: 
Passed  Variables:  amat, 
Returned:  amat, 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear. 


Called  By: 


matrxmanip2 


gotoxy,  pause,  disp  msg 


Version: 

Date: 

Author: 


1.0 

18  Sep  85 

Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRXMAN. PAS 

****************************************************************** 
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*«  .  „\ 


A.V. 


A 

\V\’ 


.V 


*  ft 


A***************************************************************** 

Name:  matrx_manipl 

Type:  Procedure 

Description:  This  procedure  add,  subtract  and  multiply  two  matrices 
Global  Variables  Used:  abort_command 

.Global  Variables  Changed:  None 
'Global  Constants  Used:  None 

Passed  Variables:  first,  second,  third,  mat_obj 

Returned:  third 

Files  Read:  MATRIX. DAT 

Tiles  Written:  MATRIX.DAT 

Aliases:  None 

Procedures  Called:  trim,  disp_matrx,  matrxadd,  mmatrxmlt, 

matrxsub 

Called  By:  mmatrix 

Version:  1.0 

Date:  21  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRIX. PAS 

★★★*************************************************************** 


********************************* *************************  ******** 
Name:  matrx_manip2 

Type:  Procedure 

Description:  This  procedure  invert,  transpose,  or  multiply  a 
matrix  by  a  scalar. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  first,  number,  result,  mat_obj 

Returned:  result 

Files  Read:  MATRIX.DAT 

Files  Written:  MATRIX.DAT 

Aliases:  None 

Procedures  Called:  trim,  disp_matrx,  matrxinv,  smatrxmlt, 

matrxtran 

Called  By:  mmatrix 


Version:  1.0 

Date:  21  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRIX. PAS 

****************************************************************** 


Type:  Procedure 

Description:  This  procedure  will  subtract  the  second  matrix  from 
the  the  first  and  store  it  in  the  third. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  abort_command 
Global  Constants  Used:  None 

Passed  Variables:  amat,  bmat,  cmat,  abort_command 

Returned:  cmat,  abort_command 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  matrxadd 

Called  By:  matrxmanipl 

Version:  1.0 

Date:  20  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRXMAN.PAS 

*********************************************************x******** 

*********************************************************** ******* 
Name:  matrxtran 

Type:  Procedure 

Description:  This  procedure  will  transpose  a  matrix  and  pass  it 
in  the  second  matrix  passed  to  it. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  amat,  bmat 

Returned:  amat,  bmat 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  matrxmanip2 

Version:  1.0 

Date:  18  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRXMAN.PAS 


****************************************************************** 

Name:  mats 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  file  of  matrix. 


FILE:  DATA  DICTIONARY 


D-72 


file  of  matrix 


Make_up : 

Source: 

Destination: 

Used  In:  recover,  update,  matrxmanipl, 

matrxmanip2,  disp_matrx,  getmat, 
chgmat 

****************************************************************** 

****************************************************************** 
Name:  max_cols 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  This  is  the  maximum  number  of  columns  a  matrix  may 

have . 

Make_up:  Integer 

Source:  Declared  in  concons 

Destination: 

Used  In:  matrix,  getmat 

****************************************************************** 

****************************************************************** 
Name :  max_deg 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  This  is  the  maximum  degree  of  the  polynomials. 

Make_up:  Integer 

Source:  Declared  in  concons 

Destination: 

Used  In:  polynomial,  gettf,  getpoly 

****************************************************************** 

*********  ********************************************************* 
Name:  max_degl 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  This  is  the  maximum  degree  of  the  polynomials  plus 

one. 

Make_up:  Integer 

Source:  Declared  in  concons 

Destination: 

Used  In:  polynomial 

*****  **  *********************************************************** 

*****  ***  *  ********************************************************* 
Name:  max_rows 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  This  is  the  maximum  number  of  rows  allowed  in  a 

matrix. 
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Integer 

Declared  in  concons 


Make_up : 

Source: 

Destinat ion: 

Used  In:  matrix,  getmat 

****************************************************************** 

****************************************************************** 

Name:  method 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  the  method  by  which  the  polynomial  will  be 

entered,  either  poly  or  factored  form. 

Ma  k e_up :  cmdwo  r d 

Source: 

Destination: 

Used  In:  poly,  gettf,  get_poly 

****************************************************************** 

****************************************************************** 
Name:  mmatrix 

Type:  Procedure 

Description:  This  procedure  will  decode  the  command  string  from 
define. pas  and  all  the  appropriate  procedures. 

Global  Variables  Used:  abort_command,  cmdbuffer 

Global  Variables  Changed:  abort_command 

Global  Constants  Used:  as_assigned 

Passed  Variables:  cmdbuffer,  wordnumber 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  pause,  clear,  matrxmanip2,  get_matrx_name, 

get_r_num,  gotoxy,  out_string,  disp_matrx 
trim,  disp_msg,  matrxmanipl 
Called  By:  disp 

Version:  1.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRIX. PAS 

★  it  It  It  *  *  it  *★*★★***★**  ★  *  *  *★  it  it  **  it  *  ******  *  *  *  *  *****  *  ★  ******  ****  ** 

a********************************************************** ******* 

Name:  mmatrxmlt 

Type:  Procedure 

Description:  This  procedure  will  multiply  the  second  matrix  to 
the  the  first  and  store  it  in  the  third. 

Global  Variables  Used:  abort  command 
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Global  Variables  Changed:  abort_command 
Global  Constants  Used:  None 

Passed  Variables:  amat,  bmat,  cmat,  abort_command 

Returned:  cmat,  abort_command 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear,  gotoxy,  pause,  disp_msg 
Called  By:  matrxmanipl 

Version:  1.0 

Date:  18  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRXMAN . PAS 

****************************************************************** 

****************************************************************** 
Name:  modify 

Type:  Procedure 

Description:  This  procedure  contains  the  logic  to  decide  which 
modification  procedure  should  be  called  and  calls 
it . 

Global  Variables  Used:  cmdbuffer 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  cmdbuffer,  wordnumber 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  inroot,  delroot,  chgmat,  clear,  trim, 

disp_msg,  pause 

Called  By:  select_rout ine 

Version:  1.0 

Date:  22  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MODIFY. PAS 

****************************************************  ** ************ 

* 

****************************************************************** 
Name:  MODIFY. PAS 

Type:  File 

Description:  This  file  contains  the  logic  to  decide  which 

modification  procedure  should  be  called  and  calls 
it . 

Procedures  Contained:  chgmat,  modify 
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Version: 

1.0 

Date: 

22  Sep  85 

Author: 

Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  US. 
*********  ************  ********** 

****************************************************************** 

Name :  mod_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  the  number  of  the  message  for  the  modifiy 

command. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  help 


****************************************************************** 

Name:  mod_obj 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  to  indicate  the  object  that 

the  called  routine  is  to  operate  with. 

Make_up:  cmdword 

Source: 

Destinat ion: 

Used  In: 


Name:  move_matrix 

Type:  Procedure 

Description:  This  procedure  receives  the  source  and  destination 
matrix  locations,  reads  the  source  matrix  location 
and  copies  it  to  the  destination. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  sorce,  dest  loc 


Global  Constants  Used:  Non 

Passed  Variables:  sorce,  d 

Returned:  None 

Files  Read:  TF&POLS . DAT 

Files  Written:  TF&POLS . DAT 

Aliases:  None 

Procedures  Called:  None 
Called  By:  ccopyy 


Version: 

Date: 


2.0 

4  Sep  85 
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Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modifeid  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  COPY. PAS 

****************************************************************** 

****************************************************************** 
Name:  move_poly 

Type:  Procedure 

Description:  This  procedure  receives  the  source  and  destination 
poly  locations,  reads  the  source  poly  location 
and  copies  it  to  the  destination. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  sorce,  dest_loc 
Returned:  None 

Files  Read:  TF&POLS . DAT 

Files  Written:  TF&POLS. DAT 

Aliases:  None 

Procedures  Called:  None 
Called  By:  ccopyy 

Version:  2.0 

Date:  4  Sep  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modifeid  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  COPY. PAS 

****************************************************************** 

****************************************************************** 
Name:  move_tf 

Type:  Procedure 

Description:  This  procedure  receives  the  source  and  destination 
tf  locations,  reads  the  source  tf  location 
and  copies  it  to  the  destination. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  sorce,  dest_loc 

Returned:  None  * 

Files  Read:  TF&POLS. DAT 

Files  Written:  TF&POLS. DAT 

Aliases:  None 

Procedures  Called:  None 
Called  By:  ccopyy 

Version:  2.0 
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Date:  4  Sep  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modifeid  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  COPY. PAS 

****************************************************************** 

****************************************************************** 
Name :  MSDWCONS . PAS 

Type:  File  of  constants 

Description:  This  file  contains  the  constant  definitions  for  the 

MICROSDW  ans  ICECAPPC  routines 
Global  Variables  Used: 

Global  Variables  Changed: 

Global  Constants  Used: 

Passed  Variables: 

Returned: 

Files  Read: 

Files  Written: 

Aliases: 

Procedures  Called: 

Called  By: 

Version:  4.0 

Date:  19  September  85 

Author:  Paul  A  Moore,  Capt,  USAF 

Modifiers:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MSDWCONS. PAS 

****************************************************************** 

****************************************************************** 

Name :  MSDWTYPE . PAS 

Type:  File  of  type  definitions 

Description:  This  file  contains  the  type  definitions  for  the 

MICROSDW  and  ICECAPPC  routines 
Global  Variables  Used: 

Global  Variables  Changed: 

Global  constants  Used: 

Passed  Variables: 

Returned: 

Files  Read: 

Files  Written: 

Aliases: 

Procedures  Called: 

Called  By: 

Version:  4.0 

Date:  19  September  85 
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i 

Name: 

msg 

Aliases : 

None 

4 

m 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  the  structure  that  contains 

the  message  record  number  and  length  in  number  of 
records . 

► 

mC 

Make  up: 

msg  =  record 

loc  rec  :  inter er; 

■4 

f 

m 

length  :  byte; 

end; 

Source: 

Declared  in  msdwtype 

- 

Destination: 
Used  In: 

msdwtype 

Name:  msg_array 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  This  is  the  type  definition  of  the  structure  that 

contains  the  message  directory. 

Make_up:  arrayt  1 . . num_msg_d i r  ]  of  msg 

Source:  Declared  in  icecappc 

Dest inat ion : 

Used  In:  icecappc,  get_data 


★a********************************************* 
Name:  msg_dat 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  one  line  from  the  file  of  the 

message  text. 

Make_up:  msg_dat  =  array[  1 . . num_msg_l ine  ]  of  stringt  screen 

width  ]  : 

Source:  Declared  in  msdwtype 

Destination: 

Used  In: 

*********************************************** 


Name : 


msg_dir 
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Aliases:  None 

Type  Of  Entry:  Global  variable  and  data  flow 

Description:  This  is  the  message  directory  that  contains  the 

record  number  of  the  messages  in  the  HELP . TXT  file. 

It  also  is  a  counter  for  the  total  number  of  messages 
in  HELP . TXT 

Make_up:  msg_array 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  disp_msg,  clearjnsg, 

get  data 

****************************************************************** 

****************************************************************** 
Name:  msg_line 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  This  is  the  type  definition  of  a  long  string 

which  can  then  be  used  as  a  parameter  for  passing 
between  procedures. 

Make_up:  string[  screen_width  ] 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  icecappc,  ucase,  out_string, 

get_strng,  recover,  update, 

ck  chr,  get_poly_name,  svideobold, 

svldeolow 

****************************************************************** 

****************************************************************** 

Name:  msg_num 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  the  message  from  the 

message  file  that  will  either  be  displayed  or 
cleared. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  disp_msg,  clearjnsg 

*************************** *************************************** 

****************************************************************** 
Name:  MSG. PAS 

Type:  File 

Description:  This  file  contains  the  procedures  to  display  and  to 

clear  a  message. 

Procedures  Contained:  disp_line,  dispjnsg,  clearjnsg 

Version:  3.1 
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Date:  2  3  Aug  85 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 

****************************************************************** 
Name:  msg_txt 

Aliases:  None 

Type  Of  Entry:  Global  accessed  file 

Description:  This  is  the  file  that  contains  the  message  text 

for  display  throughout  the  program.  System  warnings, 
instructions,  error  messages  and  help  information  is 
contained  in  this  file. 

Make_up:  file  of  msg_dat 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  disp_line 

****************************************************************** 

★★★★★★★★★★★★★A**************************************************** 

Name:  n 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  polyadd 

****************************************************************** 

****************************************************************** 

Name:  naa 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  polymlt 

*************Hr**************************************************r** 

****************************************************************** 

Name:  nbb 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  counter. 

Make_up:  Integer 

Source: 
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Destination: 

Used  In:  polymlt,  polysub 

*****************************************************************4 

****************************************************************** 

Name:  nbmat 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  File  of  matrix. 

Make_up:  matrix 

Source : 

Destination: 

Used  In:  matrxsub 

****************************************************************** 

****************************************************************** 

Name:  nbpoly 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  storage  location  for  the  polynomial. 

Make_up:  polynomial 

Source: 

Destination: 

Used  In:  polysub 

****************************************************************** 

****************************************************************** 

Name:  nc 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  polyadd 

****************************************************************** 

****************************************************************** 

Name:  ncc 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  counter.  * 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  polyadd 

****************************************************************** 

****************************************************************** 
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Name:  newpoly 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  storage  location  for  the  polynomial  after 

it  has  been  modified. 

Make_up:  polynomial 

Source: 

Destination: 

Used  In:  inroot,  delroot 

****************************************************************** 

****************************************************************** 

Name:  nn 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  polyadd 

****************************************************************** r 

★★★★★a************************************************************ 

Name :  no 

Aliases:  None 

Type  Of  Entry:  Global  constant 
Description:  Boolean  Variable 

Make_up:  Boolean 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In: 

****************************************************************** 

★A***************************************************************'* 

Name:  nographics 

Type:  Procedure 

Description:  This  procedure  removes  the  terminal  from  the  graphics 
mode . 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 
Global  Constants  Used:  term_length 

Passed  Variables:  None  , 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called: 

Called  By:  rectangle,  lef t_bracket ,  right  bracket 
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Date:  21  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

★★★a************************************************************** 

****************************************************************** 
Name:  nohighlight 

Type:  Procedure 

Description:  This  procedure  removes  the  terminal  from  the  reverse 
video  mode. 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 
Global  Constants  Used:  term_length 

Passed  Variables:  None 
Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called: 

Called  By:  pause,  title_slide,  prompt_cmd, 

proces_error , ccopyy,  get_r_num, 

get_real,  make_pretty,  roots, 

delroot,  form,  get_poly_name , 

polymlt,  get_matrx_name 

Version:  2.0 

Date:  21  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 


Name:  number 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  variable 

Make_up:  Real 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  out_int,  get_int,  out_real, 

get_real,  *get_r_num,  get_fact, 

get_unfact  spolymlt,  matrxmanip2 , 

ppoly ,  dispmatrx,  polymanip2, 

smatrxmlt,  get_matr ix_entr ies ,  disptf, 

mmatrix,  getmat,  chgmat, 

disppoly,  inroot 

****************************************************************** 
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****************************************************************** 
Name:  number_of_commands 

Aliases:  None 

Type  Of  Entry:  Data  flow 

Description:  The  number  of  command  words  entered  by  the  user, 

calculated  by:  buf f erpointer  -  1. 

Make_up:  Integer 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  select_routine 

*********** ********************  *********************************** 

****************************************************************** 

Name:  num_bools 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  number  of  boolean  variables  within  each 

parameter  group. 

Make_up:  Integer  (10) 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype 

****************************************************************** 

****************************************************************** 
Name:  num_col 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  cols  in  a  matrix. 

Make_up:  Integer 

Source: 

Destination : 

Used  In:  disp_matrx,  chgmat,  getmat, 

make_pretty_large_raatr ix_one ,  get_matrx_entries 

********************************************************  ********** 

****************************************************************** 
Name:  num_cols 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  columns  in  a  matrix 

Make_up:  Integer  * 

Source: 

Destination: 

Used  In:  lef t_bracket ,  r ight_bracket 

*********************************************** 


Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  degree  of  the  numerator  poly¬ 

nomial. 

Make_up:  Integer 

Source: 

Destination:  : 

Used  In:  gettf 

******************************  ********************* ******* ******** 
a*****************************  ******* ****************** *********** 

Name:  numerator 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  numerator  polynomial. 

Make_up:  Polynomial 

Source: 

Destination: 

Used  In:  gettf,  disptf 

*********************************************************1T******** 

**********************************************************  ******** 

Name:  num_ints 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  number  of  integer  variables  within  each 

parameter  group. 

Make_up:  Integer  (10) 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype 

****************************************************************** 

****************************************************************** 

Name:  num_msg_dir 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  length  of  the  message  directory — i.e.  'he 

HELP . TXT  file  is  limited  to  this  number  of 
messages . 

Make_up:  Integer 

Source:  Declared  in  msdwcons 

Destinat ion: 

Used  In:  msdwtype,  icecappc,  get_data 

************************* ***************************************** 

*  *  *******  ********************************************************* 
Name:  num_msg_line 

Aliases:  None 
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Type  Of  Entry:  Global  constant 

Description:  The  number  of  lines  of  message  text  available  in 

the  file. 

Make_up:  Integer 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype 

a***************************************************************** 


****************************************************************** 

Name:  num_of_commands 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  number  of  commands. 

Make_up:  Integer 

Source:  val_n_dec,  get_cmd 

Destination: 

Used  In:  val_n_dec,  get__cmd 

********************************************  **************  ******** 


*  ** *************************************************************** 

Name:  num_param_group 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  number  of  parameter  groups  in  the  file 

M I CROWS DW. SYS 
Make_up:  Integer 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype 

****************************************************************** 


Name: 

Aliases: 

Type  Of  Entry 
Description: 

Make_up: 
Source: 
Destination: 
Used  In: 


num_ptr_recs 

None 

:  Global  constant 

The  number  of  pointers  within  each  record  of 
command  syntax  data  structure. 

Integer 

Declared  in  msdwcons 
msdwtype  5 


the 


****************************************************************** 

Name:  num_ptrs 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  number  of  records  with  decoding  information  in 
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the  command  syntax  structure.  If  the  displayed  menu 
contains  strange  characters  there  may  be  insufficent 
num_ptrs. 

Make_up:  Integer 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype,  get_data 

****************************************************************** 

****************************************************************** 

Name:  num_reals 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  number  of  real  variables  within  each  parameter 

group. 

Makeup:  Integer 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype 

a***************************************************************** 

****************************************************************** 
Name :  num_row 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  rows  in  a  matrix. 

Makeup:  Integer 

Source: 

Destination: 

Used  In:  disp_matrx,  chgmat,  getmat, 

make_pretty_large_matr  ix_one ,  get__matrx_entr  ies 
****************************************************************** 

****************************************************************** 
Name:  num_rows 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  rows  in  a  matrix. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  lef t_bracket ,  r ight_bracket 

****************************************************************** 

*******  *********************************************************** 

Name:  num_st rings 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  number  of  strings  within  each  parameter 
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group. 

Make_up:  Integer 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype 

****************************************************************** 

****************************************************************** 

Name:  num_words 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  The  number  of  dictionary  words  in  the  command 

syntax  data  structure.  If  words  are  missing  from 
your  menu  increasing  this  number  should  solve  the 
problem. 

Make_.up:  Integer 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  msdwtype,  get_data 

**************  *.*  *  *  *  *•*  ********************************************* 

****************************************************************** 
Name:  oldpoly 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  original  polynomial  before 

it  is  modified. 

Make_up:  polynomial 

Source: 

Destination: 

Used  In:  inroot,  delroot 

****************************************************************** 

****************************************************************** 
Name:  odpol 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  denominator  polynomial  of  the 

OLTF. 

Make_up:  polynomial 

Source: 

Destination:  * 

Used  In:  form 

****************************************************************** 
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Description:  This  variable  is  the  numerator  polynomial  of  the 

OLTF . 

Make_up:  polynomial 

Source: 

Destination: 

Used  In:  form 

******************************************************  itHt  ********** 


****************************************************************** 
Name:  on_off 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  displayed  in  the  status  line 

at  the  bottom  of  the  screen. 

Make_up:  Char 

Source:  bld_stat_line 

Destination: 

Used  In:  bld_stat_line 

****************************************************************** 

****************************************************************** 
Name:  ostring 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  string  the  user  wishes  to  output. 

Make_up:  msg_line 

Source:  out_string 

Destination: 

Used  In:  out_string 

****************************************************************** 


****************************************************************** 
Name:  out_int 

Type:  Procedure 

Description:  This  procedure  directs  the  output  of  integers. 

Global  Variables  Used:  crt,  trans,  printer, 

temp,  trans_file,  temp_file, 

list_dev 

Global  Variables  Changed:  temp_file,  trans_file,  list_dev 

Global  Constants  Used:  None 

Passed  Variables:  number,  field,  dest 

None 
None 

temp_file,  trans_file,  list_dev, 

temp. out,  transact . ion,  printer. out 

None 


Returned: 

Files  Read: 
Files  Written: 


Aliases: 

Procedures  Called: 
Called  By: 


make_pretty,  inroot, 
make_pretty_large_matr ix_one. 
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make_pretty_small_matr ix 

Version:  1.2 

Date:  18  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  GET I NT . PAS 

A***************************************************************** 

****************************************************************** 
Name:  OUTPUT. PAS 

Type:  File 

Description:  This  file  contains  the  procedure  that  handles  all  of 
output . 

Procedure  Contained:  out_string 
Version:  1.0 

Date:  1  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

****************************************************************** 

********************************* ** *** ** ************************** 
Name:  out_real 

Type:  Procedure 

Description:  This  procedure  outputs  real  numbers  to  the  crt  or 
any  of  the  required  files. 

Global  Variables  Used:  crt,  trans,  printer,  temp 

list_dev 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 


Passed  Variables: 

number,  fieldwidth, 

dest 

Returned: 

None 

Files  Read: 

trans_file,  temp_file, 

list_dev 

Files  Written: 

printer. out,  temp. out, 

transact. ion 

Aliases: 

Procedures  Called: 

None 

Called  By: 

get_fact,  get_unfact, 

get_r  num 

disptf,  chgmat, 

disppoly,  disp_matrx 

inroot , 

Version: 

1.4 

Date: 

2  Sep  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In;File:  REALS. PAS 

**********************************************************^******* 

****************************************************************** 
Name:  out_string 

Type:  Procedure 

Description:  This  procedure  handles  all  string  output  for  the  pro¬ 
gram.  Whenever  system  output  is  required,  this  module 
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is  called,  the  output  is  directed  to  the  appropriate 
device.  (  crt,  printer,  transaction,  temporary  ) 

Global  Variables  Used:  trans,  printer,  temp,  crt,  list_dev, 

trans_file,  temp_file 
Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  ostring,  dest  : 

Returned:  None 

Files  Read:  trans_file,  temp_file,  list_dev 

Files  Written:  printer. out,  transaction,  temp. out 

Aliases:  None 

Procedures  Called: 

Called  By:  pause,  clear_msg,  disp_line, 

instruction,  prompt_help,  prompt_cmd, 

displa_commandword,  recover,  update, 

ccopyy,  get_real,  get_r_num, 

make_pretty,  gettf,  get_poly, 

getmat,  get_poly_name ,  disptf, 

chgmat,  ppoly,  inroot, 

delroot,  mmatrix,  form, 

disppoly ,  make_pretty_large_matr ix_one, 

disp_matrx,  make_pretty_small_matr ix, 
disp,  get_matrx_name 

Version:  1.0 

Date:  1  Aug  83 

Author:  Vincent  M  Parisi  IX,  Capt,  USAF 

Contained  In  File:  OUTPUT. PAS 

ititie'kieifit-kieicieieit'k’kiticifieititieieieieic'kif'kit'kif’k'kificic'kitit’k-k'kie'kfeit'k'k'kieiciticie-kitie'kieieic-k’kic'k 

****************************************************************** 
Name:  param_group 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  the  structure  that  contains  the 

program's  parameters  which  are  used  throughout  the 
program. 

Make_up:  param_group  =  record 

bools  :  arrayt  l..num_bools  ]  of  boolean; 
ints  :  arrayt  l..num_ints  ]  of  integer; 
reals  :  arrayt  1 . . num_reals  ]  of  reals; 

;  strings  :  arrayt  1 .. num_st rings  ]  of  paramstring; 
end; 

Source:  Declared  in  msdwtype 

Dest  inat ion : 

Used  In:  icecappc,  msdwtype 

icititlt-kititititlcic'kltitlt-kie’k'k  +  'kicitlticic-k'k’kitit’k'k'k'k'k'kit’kit’kitlt'kitit'k'kic'k’kic'kicititlclclcic'klt'kicifk 
**************************************-r*************************** 
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Name:  paramstring 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  a  fourteen  char  string  to  be 

used  thruout  the  program. 

Make_up:  paramstring  =  string[  14  ] 

Source:  Declared  in  msdwtype  ; 

Destinat ion: 

Used  In:  get_data 

****************************************************************** 

****************************************************************** 
Name:  pause 

Type:  Procedure 

Description:  This  procedure  waits  for  user  response  to  continue 
anytime  there  is  a  stop  in  the  program. 

Global  Variables  Used:  blanks,  status_line,  stat_on 

Global  Variables  Changed:  None 

Global  Constants  Used:  screen_width,  crt_only,  stat_l ine_width 

Passed  Variables:  None 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  gotoxy,  highlight,  nohighlight, 

out_str ing 

Called  By:  proces_error ,  recover,  update, 

ccopyy,  help,  get_reai, 

get_fact,  matrxadd,  get_matrx_entr ies , 

mmatrxmlt,  disptf,  getmat, 

matrxinv,  define,  modify, 

chgmat ,  dispmatrx,  inroot, 

delroot,  mmatrix,  form 

polymanip,  polymanip2,  get_poiy_name , 

get_matrx_name ,  get_poly,  disp, 

select_routine 

Version:  1.1 

Date:  29  Oct  84 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Paul  A  Moore,  Capt,  USAF 
Contained  In  File:  PAUSE. PAS 

****************************************************************** 

****************************************************************** 
Name:  PAUSE. PAS 

Type:  File 

Description:  This  file  waits  for  user  response  to  continue 
anytime  there  is  a  stop  in  the  program. 


FILE:  DATA  DICTIONARY 


D-93 


Procedures  Contained:  pause 
Version:  1.1 

Date:  29  Oct  84 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Modified  by:  Paul  A  Moore,  Capt,  USAF 
****************************************************************** 

****************************************************************** 

Name:  pi 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  is  the  value  of  pi. 

Make_up:  real 

Source: 

Destination: 

Used  In: 

****************************************************************** 

****************************************************************** 

Name:  pol 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  polynomial. 

Make_up:  polynomial. 

Source: 

Destination: 

Used  In:  recover,  update,  disppoly,  get_poly, 

poly_into_storage,  poly_f rom_storage 

****************************************************************** 

****************************************************************** 

Name:  poll 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  polynomial. 

Make_up:  polynomial. 

Source : 

Destination : 

Used  In:  polymanip,  polymanip2 

****************************************************************** 

****************************************************************** 

Name:  pol 2 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  polynomial. 

Make_up:  polynomial. 

Source: 

Destination: 
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Used  In:  polymanip,  polymanip2 

****************************************************************** 


****************************************************************** 
Name:  pol3 

Aliases:  None 

Type  Of  Entry:  Variable  ; 

Description:  This  is  a  polynomial. 

Make_up:  polynomial. 

Source: 

Destination: 

Used  In:  polymanip 

****************************************************************** 

****************************************************************** 

Name:  pola 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  file  of  polynomial. 

Make_up:  file  of  polynomial. 

Source: 

Destination: 

Used  In:  recover,  update 

****************************************************************** 

****************************************************************** 

Name:  pol_deg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  the  degree  of  the  polynomial. 

Make_up:  Integer 

Source: 

Dest ination: 

Used  In:  get_poly 

****************************************************************** 

************************************************  ****************** 

Name:  pols 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  file  of  polynomial. 

Make_up:  file  of  polynomial. 

Source: 

Destination : 

Used  In:  recover,  update 

****************************************************************** 


Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  polynomial. 

Make_up:  polynomial. 

Source: 

Destination: 

Used  In:  poly,  roots,  get‘_unfact, 

form_poly,  get_fact,  move_tf, 
move_poly 

****************************************************************** 

a***************************************************************** 

Name:  poly 

Type:  Procedure 

Description:  This  procedure  gets  a  polynomial  in  either  factored 
or  poly  form. 

Global  Variables  Used:  abort_command 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  method,  poly,  disp_row, 

abort_command 
Returned:  poly 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  get_unfact,  get_fact, 

roots,  formjpoly 

Called  By:  gettf 

Version:  1.2 

Date:  25  Sep  85 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Modified  by:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETTF. PAS 

****************************************************************** 

****************************************************************** 
Name:  polyadd 

Type:  Procedure 

Description:  This  procedure  will  add  the  second  polynomial 
5  to  the  first  and  store  it  in  the  third. 

Global  Variables  Used:  polynomial 

Global  Variables  Changed:  polynomial 
Global  Constants  Used:  None 

Passed  Variables:  apoly,  bpoly,  cpoly 

Returned:  apoly,  bpoly,  cpoly 

Files  Read:  None 

Files  Written:  None 
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Aliases:  None 

Procedures  Called:  roots 

Called  By:  polyman  ip,  polysub 

Version:  2.0 

Date:  18  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  0SAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLYMAN. PAS 

****************************************************************** 

****************************************************************** 

Name:  poly_file 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  a  file  of  polynomial. 

Make_up:  polynomial 

Source: 

Destination: 

Used  In:  move_poly 

****************************************************************** 

****************************************************************** 
Name:  poly_f rom_storage 

Type:  Procedure 

Description:  This  procedure  will  remove  a  polynomial  into  storage. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  choice,  pol 

Returned:  None 

Files  Read:  TF& POLS .DAT 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  trim 

Called  By:  form 

Version:  1.0 

Date:  7  Oct  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  FORM. PAS 

****************************************************************** 

****************************************************************** 
Name:  poly_into_storage 

Type:  Procedure 

Description:  This  procedure  will  place  a  polynomial  into  storage. 
Global  Variables  Used:  None 
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Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  choice,  pol 
Returned:  None 

Files  Read:  None 

Files  Written:  TF&POLS.DAT 

Aliases:  None 

Procedures  Called:  trim 
Called  By:  form 

Version:  1.0 

Date:  7  Oct  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  FORM. PAS 

******* *************** ********** ********************************** 

****************************************************************** 
Name:  polymanip 

Type:  Procedure 

Description:  This  procedure  will  add,  subtract,  or  multiply  two 
polynomials . 

Global  Variables  Used:  polynomial 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  first,  second,  result 

Returned:  result 

Files  Read:  TFS. POLS  .DAT 

Files  Written:  TF&POLS .DAT 

Aliases:  None 

Procedures  Called:  trim,  disppoly,  polyadd,  polymlt, 

poly sub,  pause 
Called  By:  ppoly 

Version:  1.0 

Date:  6  Sept  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLY. PAS 

**************************************************************  **** 

****************************************************************** 
Name:  polymanip2 

Type:  Procedure 

Description:  This  procedure  will  multiply  a  polynomial  and  a  'calar. 
Global  Variables  Used:  polynomial 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  first,  number,  result,  poly_obj 
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result 
None 
None 
None 

trim,  disppoly,  spolymlt 
PPoly 

Version:  1.0 

Date:  8  Oct  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Gapt,  USAF 
Contained  In  File:  POLY. PAS 

***************************************************************** 


Returned: 

Files  Read: 

Files  Written: 
Aliases: 

Procedures  Called: 
Called  By: 


****************************************************************** 
Name:  POLYMAN. PAS 

Type:  File 

Description:  This  file  will  add,  subtract,  or  multiply  two 
polynomials.  Additionally,  it  will  multipy  a 
polynomial  by  a  scalar. 

Procedures  Contained:  polyadd,  polymlt,  polysub,  spolymlt 

Version:  3.0 

Date:  8  Oct  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 


Name:  polymlt 

Type:  Procedure 

Description:  This  procedure  will  multiply  the  second  polynomial 
to  the  first  and  store  it  in  the  third. 

Global  Variables  Used:  polynomial 

Global  Variables  Changed:  polynomial 

None 
bpoly , 


Global  Constants  Used: 
Passed  Variables:  apoly. 
Returned: 

Files  Read: 

Files  Written: 

Aliases: 


cpoly 

None 

None 

None 


cpoly 


Procedures  Called:  roots,  clear, 

nohighlight 

Called  By:  polymanip,  form 


gotoxy, 


Version: 

Date: 

Author: 


1.0 

4  Sep  85 

Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLYMAN. PAS 


highl ight , 
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****************************************************************** 

Name:  poly_name 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  i's  the  name  of  polynomial  obtained  by 

this  procedure. 

Make_up:  msg_line 

Source: 

Destination: 

Used  In:  ppoly,  get_poly_name 

a***************************************************************** 


****************************************************************** 
Name:  polynomial 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Record  that  contains  the  components  of  a  polynomial 

Make_up:  polynomial  *  record 

change  :  boolean; 

coefficient  :  real; 


Source: 
Destinat: 
Used  In: 


polydeg  :  int 
polyfact  :  arr 
polypoly  :  arr 
end; 

Declared  in  concons 


:  integer; 

:  array[  l..max_deg  ]  of  complex; 
:  array[  l..maxdegl  ]  of  real; 


poly,  roots,  get_unfact,  get_poly, 

form_poly,  get_fact,  move_tf,  polymamp, 

move_poly,  gettf,  recover,  polyman ip2 

update,  polyadd,  polysub,  spolymlt, 

disptf,  disppoly,  inroot,  delroot, 

ppoly,  get_poly_name,  poly_f rom_stor'age, 

poly  into  storage,  form,  polymlt 


polyman ip2 , 
spolymlt , 
delroot , 


****************************************************************** 

Name:  poly_obj 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  name  of  polynomial  passed  to 

this  procedure. 

Make_up:  cmdword 

Source: 

Destination : 

Used  In:  ppoly,  polymanip 

****************************************************************** 
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Name:  POLY. PAS 

Type:  File 

Description:  This  file  contains  the  procedures  to  display  and 
manipulate  polynomials. 

Procedures  Contained:  disppoly,  polymanip,  ppoly, 

get_poly_name,  polymanip2 

Version:  3.0 

Date:  8  Oct  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczyhski,  Capt,  USAF 

****************************************************************** 

****************************************************************** 

Name:  polys 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  file  of  polynomial. 

Make_up:  file  of  polynomial. 

Source: 

Destination: 

Used  In:  gettf,  disptf,  poly_into_storage, 

inroot,  del root,  poly_f rom_storage, 
polymanip,  polymanip2,  disppoly,  get_poly 
****************************************************************** 

******************************************************* **** ******* 
Name:  poly sub 

Type:  Procedure 

Description:  This  procedure  will  subtract  the  second  polynomial 
form  the  first  and  store  it  in  the  third. 

Global  Variables  Used:  polynomial 

Global  Variables  Changed:  polynomial 

Global  Constants  Used:  None 

Passed  Variables:  apoly,  bpoly,  cpoly 

Returned:  cpoly 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  polyadd 

Called  By:  polymanip 


Version:  1.0 

Date:  4  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLYMAN. PAS 
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****************************************************************** 


Name:  pos 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  a  the  passed  position. 

Make_up:  Integer 

Source:  1 

Destination: 

Used  In:  svideolow,  svideobold 

****************************************************************** 

****************************************************************** 
Name:  ppoly 

Type:  Procedure 

Description:  This  procedure  will  get  the  name  of  a  polynomial  from 
the  screen. 

Global  Variables  Used:  abort_command,  cmdbuffer 

Global  Variables  Changed:  None 

Global  Constants  Used:  as_assigned 

Passed  Variables:  cmdbuffer,  wordnumber 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear,  disp_msg,  trim,  disppoly, 

get_poly_name,  gotoxy,  out_string, 
polymanip,  get_r_num,  polymanip2, 
pause 

Called  By:  disp 

Version:  2.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLY. PAS 

****************************************************************** 

****************************************************************** 
Name:  pr_cmd_col 

Aliases:  None 

Type  Of  Entry:  Constant  definition  and  data  flow 
Description:  This  is  the  column  location  that  the  logo  appears 

at. 

Make_up:  Integer 

Source:  get_cmd 

Destination: 

Used  In:  get_cmd 

*  ***************************************************************** 


************************************************** **************** 
Name:  pr_cmd_row 

Aliases:  None 

Type  Of  Entry:  Constant  definition  and  data  flow 
Description:  This  is  the  row  location  that  the  logo  appears 

at. 

Make_up:  Integer' 

Source:  get_cmd 

Destination: 

Used  In:  get_cmd 

**********************  **  ****************************************** 

****************************************************************** 
Name:  pr_hlp_row 

Aliases:  None 

Type  Of  Entry:  Constant  definition  and  data  flow 
Description:  This  is  the  row  location  that  the  command  word 

prompt  appears  on. 

Make_up:  Integer 

Source:  get_cmd 

Destination: 

Used  In:  get_cmd 

****************************************************************** 

****************************************************************** 
Name:  print 

Aliases:  None 

Type  Of  Entry:  Global  file  variable  and  data  flow 
Description:  This  is  an  array  that  contains  the  printer  control 

codes. 

Make_up:  print_array 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc 

*  **  *  it -kirk  *  **  ★  ****************************************************** 

*****  *******  ****************************************************** 

Name:  print_array 

Aliases:  None 

Type  Of  Entry:  Type  definition 

Description:  This  is  the  type  declaration  of  the  global  variable 

that  contains  the  printer's  control  codes. 

Make_up:  array[  1 . .pr inter_length  ]  of  byte 

Source:  Declared  in  icecappc 

Destination:  N/A 

Used  In:  icecappc,  get_data 

****************************************************************** 

**********************************************************  ******** 
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Name:  print_dat 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  of  the  type  print_array. 

Make_up:  print_array 

Source: 

Destination:  1 

Used  In:  get_data 

**************  *******  ********************************************* 

****************************************************************** 

Name:  print_line 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  the  variable  name  for  output  line. 

Make_up:  string[  screen_width  ] 

Source:  disp_line 

Destination: 

Used  In:  disp_line 

******************************************** ********************** 

***★****★******★★★**★★★******★*-★ *  *  *******************************  * 

Name:  print_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  message  number  for  help  on  the 

print  command. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  help 

****************************************************************** 

****************************************************************** 
Name:  printer 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  This  variable  is  the  flag  that  indicates  whether 

the  printer  file  is  on.  i.e.  should  all  printer 
directed  output  be  saved  in  the  printer  file. 
Makeup:  Boolean 

Source:  Declared  in  icecappc 

Dest inat ion : 

Used  In:  icecappc,  out_string,  out_int, 

bld_stat_l ine ,  get_data,  out_real 
****************************************************************** 

♦***************************************************************** 
Name:  pr inter_length 
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Aliases: 
Type  Of 
Descript 

Make_up : 
Source: 
Destinat 
Used  In: 


None 

Entry:  Global 

ion:  This  i 

codes . 
Integer 
Declared 

ion: 

icecappc , 


********************* 


constant 

s  the  length  of  the  array  for  printer  control 


in  msdwcons 

msdwtype,  get_data 


*****************  *f* **********************************?************ 

Name:  PR INTER. OUT 

Type:  File 

Description:  This  file  contains  the  output  for  the  printer.  It 
will  only  be  filled  if  printer  is  true. 

Used  In:  get_data 

****************************************************************** 


****************************************************************** 

Name:  print_line 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  a  the  line  the  message  line  should  be  displayed 

on 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  disp_line 

****************************************************************** 


Name:  PROCESER.PAS 

Type:  File 

Description:  This  procedure  handles  command  decoding  errors.  It 

prompts  the  user  for  proper  action  to  take  for  error 
correct  ion . 

Procedures  Contained:  proces_error 
Version:  1.1 

Date:  16  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

****************************************************************** 

****************************************************************** 
Name:  proces_error 

Type:  Procedure 

Description:  This  procedure  handles  command  decoding  errors.  It 

prompts  the  user  for  proper  action  to  take  for  error 
correction . 

Global  Variables  Used:  help_level,  cmdbuffer 
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cmdbuf  f er , 


Global  Variables  Changed:  None 
Global  Constants  Used:  screen  wi 


Passed  Variables: 

error  code, 

1 

buf f erpoint 

er 

Returned: 

None 

Files  Read: 

None 

Files  Written:  • 

None 

Aliases: 

None 

Procedures  Called: 

gotoxy. 

highl 

pause , 

displ 

clear  msg 

Called  By: 

get  cmd 

dth 
evel , 


ight, 

ay_commandvord , 


nohighlight , 
disp_msg , 


Version:  1.1 

Date:  16  Aug  83 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Contained  In  File:  PROCESER.PAS 

•a****************************************************************-* 

Name :  PROMPTCM . PAS 

Type:  File 

Description:  This  file  places  the  command  line  prompt  at 

the  row  and  column  input. 

Procedures  Contained:  prompt_cmd 

Version:  1.2 

Date:  30  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

★★a************************************************************ 


***************************************************************4 

Name:  prompt_cmd 

Type:  Procedure 

Description:  This  procedure  places  the  command  line  prompt  at 
the  row  and  column  input. 


Global  Variables  Used: 

Global  Variables  Changed: 
Global  Constants  Used: 

Passed  Variables:  row, 
Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  gotoxy, 

out_str ing 

Called  By:  get_cmd 


blanks 

None 

as_ass igned , 
col 


highlight, 


crt_only 


nohignl ight , 


Version: 
Date : 


1.2 

30  Oct  83 
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Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  PROMPTCM.PAS 

**********************************************************x******* 

****************************************************************** 
Name:  ,  prompt_col_of f set 

Aliases:  None 

Type  Of  Entry:  Constant 

Description:  This  is  the  offset  from  column  one  for  the  prompt. 

Make_up:  Integer 

Source:  'prompt 

Destination: 

Used  In:  prompt_help 

****************************************************************** 

************x*******************************************mcx******** 

Name :  PROMPTHE . PAS 

Type:  File 

Description:  This  file  displays  the  acceptable  command  words 
based  on  those  already  entered. 

Procedure  Contained:  prompt_help 
Version:  2.2 

Date:  27  Sep  84 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

****************************************************************** 

****************************************************************** 
Name:  prompt_help 

Type:  Procedure 

Description:  This  procedure  displays  the  scceptable  command  words 

based  on  those  already  entered. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  crt_only,  endword,  doneword 

Passed  Variables:  row,  rec_num 

Returned:  rec_num 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  gotoxy,  get_line,  svideolow, 

out_string,  svideobold 
Called  By:  get_cmd 

Version:  2.1 

Date:  20  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

Contained  In  File:  PROMPTHE. PAS 

****************************************************************** 
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**★**★**★★**★**★★***★★*****★★★★★*★**★★***★★*******★★**★****★****★* 
Name:  ptr_recs 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  an  element  within  type  dict_buffer 

.  It  defines  the  structure  that  contains  the  pointers 

;  for  the  command  syntax  data  structure. 

Make_up:  ptr  rec  =  array[  1 . . num_ptr_recs  ]  of  integer 

Source:  Declared  in  msdwtype 

Dest inat ion: 

Used  In:  msdwtype 

****************************************************************** 

**#******'>*t***i>*********#***t*****#*********iHr<r**T»*****ilr»f**'>t***H: 

Name:  r 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  variable  for  the  IBM  unique  function  stdout. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  stdout 

****************************************************************** 

****************************************************************** 
Name:  rad 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  radical  of  a  term  in  roots. 

Makeup:  Real 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 

****************************************************************** 
Name:  readcom 

Type:  Procedure 

Description:  This  procedure  reads  a  command  from  the  user  and 

splits  it  into  individual  words  in  the  command  buffer. 
Global  Variables  Used:  cmdbuffer,  macro_error,  blanks, 

abort_command,  strng 

Global  Variables  Changed:  cmdbuffer,  strng 

Global  Constants  Used:  as_assigned,  buffersize,  wordsize, 

terminal_only 

Passed  Variables:  cmdbuffer,  buf f erpointer ,  abort_command 

Returned:  cmdbuffer,  buf ferpointer 

Files  Read:  None 

Files  Written:  None 


FI LB:  DATA  DICTIONARY 


D- 108 


Aliases:  None 

Procedures  Called:  get_strng,  ucase 

Called  By:  get_cmd 

Version:  1.1 

Date:  ,  28  Oct  83 

Author^  Vincent  M  Parisi  II,  Capt ,  USAF 

Contained  In  File:  RSADCOM.PAS 

****************************************************************** 

******* ******* ******* ******** ********** ****** ************** ******* 
Name:  READCOM . PAS 

Type:  File 

Description:  This  file  reads  a  command  from  the  user  and 

splits  it  into  individual  words  in  the  command  buffer 
Procedures  Contained:  readcom 
Version:  1.1 

Date:  28  Oct  83 

Author:  Vincent  M  Parisi  II,  Capt,  USAF 

****************************************************************** 

****************************************************************** 
Name:  real_error 

Aliases:  None 

Type  Of  Entry:  Global  file  variable 
Description: 

Make_up : 

Source:  Declared  in  icecappc 

Destination: 

Used  In: 

****************************************************************** 


****************************************************************** 
Name:  real_root 

Aliases:  None 

Type  Of  Entry:  Variable 

Description;  This  variable  is  a  temporary  storage  location  for 
the  procedure  roots. 

Make-up:  Real 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 

****************************************************************** 
Name:  REALS. PAS 

Type:  File 

Description:  This  file  contains  the  procedures  to  input  and  output 
real  numbers. 
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get_real 


^  V  .  - 


Procedure  Contained:  out_real. 

Version:  2.4 

Date:  19  Aug  85 

Author:  Vincent  M  Parisi  II,  Capt ,  USAF 

Modified  By:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

****************************************************************** 


****************************************************************** 
Name:  rec_loc 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  integer  value  of  the  location 

in  a  file. 

Make-up:  Integer 

Source : 

Destination: 

Used  In:  get_location 

****************************************************************** 


****************************************************************** 
Name:  rec_num 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Points  to  the  record  number  of  the  syntax  data 

structure  of  interest. 

Make-up:  Variable  and  data  flow 

Source:  get_line,  prompthelp,  disp_line, 

dispjmsg,  get_cmd,  val_n_dec 

Destination: 

Used  In:  get_lin,  prompt_help,  disp_line, 

disp_msg,  get_cmd,  val_n_dec 

****************************************************************** 


****************************************************************** 
Name:  recover 

Type:  Procedure 

Description:  This  procedure  copies  the  user  specified  files  into 
ICECAP  ’ tf &pols . dat '  and  the  'matrix.dat'  files. 


Global  Variables  Used: 

Global  Variables  Changed: 
Global  Constants  Used: 

Passed  Variables:  None 
Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear, 

get_strng , 


abort_command 

None 

as_assigned. 


gotoxy , 
pause. 


blanks. 


crt_only , 


disp_msg, 
clear_msg , 
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\  t**.  H-i 


Called  By 


out_str ing 
select_rout ine 

Version:  2.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

J  Gary  C.  Tarczynski,  Capt,  USAF 

Contained  In  File:  UPDATE. PAS 

****************************************************************** 

a***************************************************************** 

Name:  recover_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  message  number  for  help  on  the 

recover  command. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  help 

★★a*************************************************************** 

****************************************************************** 
Name:  RECOVER. PAS 

Type:  File 

Description:  This  file  copies  the  user  specified  files  into 

ICECAP  ' tf&pols.dat '  and  the  'matrix.dat'  files. 
Procedures  Contained:  recover 
Version:  2.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

* **************************************************************** 

****************************************************************** 
Name:  rectangle 

Type:  Procedure 


Description:  This  procedure  draws  a  rectangle  of  given  dimensions 

on 

the  video  screen. 

Global  Variables 

Used: 

term 

Global  Variables 

Changed 

:  None 

Global  Constants 

Used: 

term_length 

Passed  Variables: 

line, 

column,  width,  height 

Returned: 

None 

Files  Read: 

None 

Files  Written: 

None 

Aliases: 

None 

Procedures  Called:  graph 

ics,  gotoxy,  nographics 

Called  By: 

title 

_sl ide 

PILE:  DATA  DICTIONARY 


D-lll 


Date:  27  Sep  84 

Author:  Paul  A  Moore,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 

******************************************************************* 
Name:  remain_lines 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Counter  of  the  total  number  of  lines  remaining  in 

the  selected  message. 

Make-up:  Integer 

Source: 

Destination: 

Used  In:  disp_msg 

****************************************************************** 

****************************************************************** 
Name:  repeat 1 

Aliases:  None 

Type  Of  Entry:  Label 

Description:  Used  for  goto  statement. 

Make-up:  Char 

Source: 

Destination: 

Used  In:  get_unfact,  get_fact,  recover, 

update 

****************************************************************** 

****************************************************************** 
Name:  repeat2 

Aliases:  None 

Type  Of  Entry:  Label 

Description:  Used  for  goto  statement. 

Make-up:  Char 

Source: 

Destinat ion: 

Used  In:  recover,  update 

********************************************************^********* 

**************************************************************$** 
Name:  repeatagain 

Aliases:  None 

Type  Of  Entry:  Label 

Description:  Used  for  goto  statement. 

Make-up:  Char 

Source: 

Destination: 
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Used  In:  form 


****************************************************************** 
Name:  resp 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  variable  is  the  character  response  from  the 

keyboard.  Used  when  the  system  is  put  into  a  pause 
state. 

Make-up:  Char 

Source: 

Destination: 

Used  In:  pause,  disp_msg 

****************************************************************** 


Name: 
Aliases: 
Type  Of 
Descript 


Make-up: 
Source: 
Destinat 
Used  In: 


result 

None 

Entry:  Variable 

ion:  The  variable  is  used  by  the  val  conversion.  Val 

converts  a  string  to  a  number  (  real  or  integer) 
result  is  the  location  of  any  invalid  characters. 

Integer 


get_int,  get_real,  polymanip,  polymanip2, 
chgmat,  matrxmanip2 


****************************************************************** 


Name:  r ight_bracket 

Type:  Procedure 

Description:  This  procedure  will  draw  the  right  bracket  for  a 
matrix. 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  num  rows,  num  cols 


Returned: 
Files  Read: 


None 

None 


Files  Written:  None 

Aliases:  None 

Procedures  Called:  graphics,  gotoxy,  nographics 

Called  By:  make_pretty_large_matr ix_two , 

make_pretty_small_matr ix 


Version: 
Date : 


1.0 

11  Sep  85 
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Author : 


Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETMAT.PAS 

****************************************************************** 

Name:  root_num 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  variable  the  number  of  the  root  to  be  deleted 

from  the  polynomial. 

Make-up:  Integer 

Source : 

Destination: 

Used  In:  delroot, 

****************************************************************** 


****************************************************************** 
Name:  roots 

Type:  Procedure 

Description:  This  procedure  uses  the  Bairstow's  method  of  finding 


the 

roots  of 

a  polynomial. 

Global  Variables 

Used: 

degree 

Global  Variables 

Changed: 

degree 

Global  Constants 

Used: 

maxdegl 

Passed  Variables: 

poly 

Returned: 

poly 

Files  Read: 

None 

Files  Written: 

None 

Aliases: 

None 

Procedures  Called 

:  gotoxy, 

highlight,  disp 

clear  msg ,  pause 

Called  By: 

poly, 

polymlt,  polyadd, 

Version: 

2.0 

Date : 

6  Sep  85 

isg ,  nohighlight, 
spolymlt 


Author : 


Susan  K.  Mashiko,  Capt,  USAF 
Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETTF.PAS 

************************************************************** 


*********************************************************  *  **** 
Name :  row 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  variable  is  the  row  location  on  the  screen 

Make-up:  Integer 

Source: 

Destination : 
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Used  In:  prompt_cmd,  prompt_help,  get_r_num, 

get_fact,  get_unfact,  disp_matrx, 

get _poly_name ,  disppoly,  get_matr ix_entries 

disptf,  chgmat,  make_pretty_small_matrix, 

make_pretty_large_matr ix_one,  gotoxy 

♦a************************************************* 

★★★★★♦★★★★★★★★★★★★★♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★★★★if* 

Name:  row_count 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  The  variable  is  a  counter  for  the  row  location 

on  the  screen. 

Make-up:  Integer 

Source: 

Destination: 

Used  In:  prompthelp 


Name:  screen_width 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  This  is  the  screen  width  in  characters  minus  1 

Make_up:  Integer 

Source:  Declared  in  msdwcons 

Destination: 

Used  In:  icecappc,  msdwtype,  pause, 

get_data,  proces^error ,  make_pretty, 

gettf,  displlne 

*************** 


Name: 

second 

Aliases: 

None 

Type  Of  Entry 

:  Variable 

Descript  ion: 

This  variable  if  a  matrix  or  a  polynomial 

Make_up: 

polynomial  or  matrix 

Source: 

Dest inat ion: 

Used  In: 

mmatrix,  polymanip,  ppoly 

Name : 

Aliases: 

Type  Of  Entry: 
Description: 


selection 

None 

Variable 

This  variable  is  used  to  indicate  the  option  number 
selected  by  the  user. 
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Make_up:  integer 

Source : 

Destination: 

Used  In:  form 

**********************************************************»******* 

****************************************************************** 
Name:  SELECT. PAS 

Type:  File 

Description:  This  file  receives  the  name  of  the  routine  to 
call  and  calls  it. 

Procedures  Contained:  select_rout ine 
Version:  6.0 

Date:  11  Oct  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Paul  A.  Moore,  Capt,  USAF 

**********************  Hr******************************************* 

****************************************************************** 
Name:  select_rout ine 

Type:  Procedure 

Description:  This  procedure  receives  the  name  of  the  routine  to 
call  and  calls  it. 

Global  Variables  Used:  cmdbuffer 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  call_routine ,  cmdbuffer,  number_of_commands 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  trim,  help,  define,  disp, 

ccopyy,  modify,  recover,  update, 

form,  f requency_response 
Called  By:  icecappc 

Version:  6.0 

Date:  11  Oct  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  SELECT. PAS  ; 

****************************************************************** 

****************************************************************** 
Name:  short_int 

Aliases:  None 

Type  Of  Entry:  Global  Variable 

Description:  This  variable  is  a  defined  as  a  integer. 
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Make_up:  Integer 

Source:  Declared  in  concons 

Destination: 

Used  In:  gettf,  make_pretty 

★★★a************************************************************** 

**********************************************************x******* 

Name:  show_abbreviat ion 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  This  variable  is  the  flag  that  indicates  wnether 

the  abbreviation  of  command  words  should  be  displayed. 
Makeup:  Boolean 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  get_data 


****************************************************************** 
Name:  smatrxmlt 

Type:  Procedure 

Description:  This  procedure  will  multiply  a  matrix  by  a 

scalar . 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  amat,  bmat,  number 

Returned:  bmat 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  matrx_manip2 

Version:  1.0 

Date:  20  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  MATRXMAN.PAS 


********** ****************************************-^*************** 

Name:  sorce_loc 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  integer  value  of  the  storage  loca¬ 

tion  of  the  source  for  a  copy. 

Makeup:  Integer 

Source: 
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Destination: 

Used  In:  ccopyy,  raove_tf,  move_poly, 

move_matrix 

****************************************************************** 


Name:  source 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  name  of  the  source  for  a  copy. 

Make_up:  cmdword 

Source: 

Destination: 

Used  In:  ccopyy 


Name:  spolymlt 

Type:  Procedure 

Description:  This  procedure  will  multiply  a  polynomial  by  a 

scalar . 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 

Global  Constants  Used:  None 

Passed  Variables:  apoly,  bpoly,  number 

Returned:  apoly,  bpoly 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  polymanip2,  form 


Version:  1.0 

Date:  7  Oct  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  POLYMAN. PAS 


******#***********************************************•********£**<£ 
Name:  standard_output 

Type:  Procedure 

Description:  This  procedure  will  redirect  the  output  from  TURBO 

pascal  to  the  operating  system  (MS-DOS).  This  allows 
the  IBM  PC  to  recognize  escape  codes. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  c 
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Returned:  None 
Files  Read:  None 
Files  Written:  None 
Aliases:  None 
Procedures  Called:  None 


Called  By: 


any  write  or  writeln  statement.  By  setting 
ConOutPtr : =Of s ( standard_ouput )  in  the  program 
icecappc,  then  the  address  of  this  procedure 
is  put  into  the  pointer  ConOutPtr.  This  pointer 
is  used  by  write  and  writeln  statements  to  locate 
code  for  output  to  the  terminal. 


Version:  1.0 

Date:  3  Aug  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  STDOUT.PAS 


Name:  stat  line  width 

*****************: 

*  ★  *  *  *  1 

-  j 

1 

Aliases: 

Type  Of  Entry:  Global  constant 

m 

Description:  Width  of  the  displayed  status 

Make  up:  Integer  (77) 

line 

Source:  Declared  in  icecappc 

;  .  . 

Destination:  N/A 

*,  -  4 

s 

• 

Used  In:  icecappc,  clearscreen, 

pause 

.  .  .1 

Name:  stat_on 

Aliases:  None 

Type  Of  Entry:  Global  variable  and  data  flow 

Description:  This  variable  indicates  whether  the  status  line 

should  be  displayed  on  the  CRT. 

Make_up:  Boolean 

Source:  Declared  in  icecappc 

Dest  inat ion 
Used  In: 


Used  In:  icecappc,  clear,  clearscreen, 

pause,  get_data 

*********************************************4t******************** 


Name:  status_line 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  This  variable  determines  whether  or  no  the  status 

line  will  be  displayed  or  not.  Status  line  shows 
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Make_up: 
Source: 
Destination: 
Used  In: 


the  status  of  the  printer,  transaction,  and  temp 
switches. 

string[  stat  line_width  ] 

Declared  in  Tcecappc 

clear,  clearscreen,  pause, 

bld_stat_l ine ,  get_data 

**************************************************** 


****************************************************************** 
Name :  STDOUT . PAS 

Type:  File 

Description:  This  file  will  redirect  the  output  from  TURBO 

pascal  to  the  operating  system  (MS-DOS).  This  allows 
the  IBM  PC  to  recognize  escape  codes. 

Procedures  Contained:  standard_output 
Version:  1.0 

Date:  3  Aug  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 

★★it*************************************************************** 


****************************************************************** 

Name:  step 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  counter. 

Make_up:  Integer 

Source : 

Destination: 

Used  In:  matrxinv 

****************************************************************** 


Name:  stepper 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  matrxinv  ; 

****************************************************************** 


★***************************************************************** 

Name:  stop_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  message  number  for  help  on  the 
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stop  command. 

Make_up:  Integer 

Source : 

Destination: 

Used  In:  help 

****************************************************************** 

****************************************************************** 

Name:  store 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  temporary  storage  location  for 

the  procedure  roots. 

Make_up:  Real 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 

****************************** ************************************ 

Name:  stor_loc 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  storage  location  in  the  files 

' tf&pols.dat '  and  'matrix.dat'. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  gettf,  matrxmanipl,  matrxmanip2, 

get_poly,  getmat,  inroot, 

delroot,  disppoly,  disp_matrx, 

disptf,  chgmat,  poly_into_storage, 

polymanip,  polymanip2,  poly_f rom_storage 
****************************************************************** 

****************************************************************** 
Name:  strng 

Aliases:  None 

Type  Of  Entry:  Global  variable  and  data  flow 
Description:  This  is  a  general  purpose  string  buffer. 

Make_up:  String 

Source:  Declared  in  icecappc  ? 

Destination: 

Used  In:  getchi,  ck_chr,  get_int, 

get_strng  get_real 

****************************************************************** 

****************************************************************** 
Name:  sum 
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Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  temporary  storage  location  for 

the  procedure  roots. 

Make_up:  Real 

Source: 

Destination: 

Used  In:  roots 

**************************************************************** 


**************************************************************** 
Name:  svideobold 

Type:  Procedure 

Description:  This  procedure  inserts  the  char  string  to  put  the 

screen  into  bold  video. 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 

Global  Constants  Used:  term_length 

Passed  Variables:  instring,  pos 

Returned:  pos 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  prompt_help 


Version:  1.0 

Date:  27  Sep  84 

Author:  Paul  A  Moore,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

**************************************************************** 


**************************************************************** 
Name:  svideolow 

Type:  Procedure 

Description:  This  procedure  inserts  the  char  string  to  put  the 
screen  into  low  video. 

Global  Variables  Used:  term 

Global  Variables  Changed:  None 
Global  Constants  Used:  term_length 

Passed  Variables:  instring,  pos 

pos  , 

None 
None 
None 
None 

prompt_help 


Returned: 

Files  Read: 

Files  Written: 
Aliases: 

Procedures  Called 
Called  By: 


Version: 


1.0 
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Date:  27  Sep  84 

Author:  Paul  A  Moore,  Capt,  USAF 

Contained  In  File:  TERMINAL. PAS 

it***************************************************************** 

****************************************************************** 

Name:  switch 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  flag  that  indicates  whether 

the  selected  terminal  type  is  either  the  H19  or  a 
VT 100. 

Make_up:  Boolean 

Source: 

Dest inat ion: 

Used  In:  ttype 

****************************************************************** 

**:r*************************************************************** 

Name:  swit_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  message  number  for  help  on  the 

switch  command. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  help 

****************************************************************** 

****************************************************************** 

Name:  system_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  message  number  for  help  on  the 

program  ICECAP-PC. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  help 

*******************************************  *•*  A******************** 

a***************************************************************** 

Name:  temp 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  This  variable  is  the  flag  that  indicates  whether 

the  current  transactions  should  be  saved  in  a  temp¬ 
orary  file. 
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Make_up:  Boolean 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  out_string,  bld_stat_l ine , 

out_int,  get_data,  out_real 

****************************************************************** 

****************************************************************** 
Name:  temp 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  temporary  storage  area. 

Make_up:  Real 

Source: 

Destination: 

Used  In:  matrxinv 

****************************************************************** 


****************************************************************** 
Name:  temp2 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  temporary  storage  area. 

Make_up:  Real 

Source: 

Destination: 

Used  In:  matrxinv 

****************************************************************** 


Name : 
Aliases: 
Type  Of 
Descript 


Make_up: 
Source: 
Dest inat 
Used  In: 
******** 


temp_f i le 
None 

Entry:  Global  file  variable 

ion:  This  file  temporarily  captures  the  user’s  instruc¬ 

tions.  This  will  allow  the  user  to  print  out.  results 
after  he/she  has  verified  the  results  on  the  screen 
Text 

Declared  in  icecappc 

ion: 

out_string,  out_int 

********************************************************** 


Name :  TEMP . OUT 

Type:  File 

Description:  This  file  contains  the  user  /  SW  transaction 
history  (only  the  most  recent). 

Used  In:  get_data 

****************************************************************** 
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Name:  temppol 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  a  temporary  storage  area  for  a  polynomial. 

Make_up:  polynomial 

Source:  ; 

Destination: 

Used  In:  form 

****************************************************************** 


****************************************************************** 


Name:  tempstr 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  a  string  used  for  temporary  storage 

Make_up:  Stringt  10  ] 

Source:  svideolow,  svideobold 

Destination: 

Used  In:  svideolow,  svideobold 

****************************************************************** 


****************************************************************** 


Name:  term 

Aliases:  None 

Type  Of  Entry:  Global  file  variable  and  data  flow 

Description:  This  is  an  array  that  contains  the  terminal  control 

codes.  Additionally,  it  is  an  element  of  record  type 
DATA. 


Make_up: 

Source: 

term_array 
Declared  in 

icecappc 

Destination: 
Used  In: 

icecappc , 

rectangle. 

videobold. 

svideobold. 

svideolow. 

videolow. 

clearscreen, 

clear , 

gotoxy , 

nohighlight , 

highlight. 

nographics , 

graphics , 

left  bracket, 

right  bracket 

*************************** 

******************* 

******************** 

Name: 
Aliases: 
Type  Of 
Descript 
Make_up: 
Source: 
Dest inat 
Used  In: 


term_array 

None 


Entry: 

Global  type 

ion: 

Defines  the 

arrayf  l..t 

Declared  in 

ion: 

N/A 

icecappc. 

def init ion 

type  for  the  TERM  data  flow. 
erm_length  ]  of  byte 
icecappc 

get_data 
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****************************************************************** 

Name:  term_dat 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Is  defined  as  term_array. 

Make_up:  term_array 

Source:  title_slide,  get_data 

Destination:  N/A 

Used  In:  title_slide,  get_data 

****************************************************************** 

****************************************************************** 
Name :  TERM I NAL . PAS 

Type:  File 

Description:  This  file  contains  the  procedures  that  interface 
with  the  terminal. 

Procedures  Contained:  graphics,  nographics,  highlight, 

nohighlight,  gotoxy,  clear, 

clearscreen,  videolow,  svideolow, 

videobold,  svideobold,  rectangle 

Version:  3.0 

Date:  12  Dec  84 

Author:  Paul  A  Moore,  Capt,  USAF 

****************************************************************** 

****************************************************************** 
Name:  terminal_only 

Aliases:  None 

Type  Of  Entry:  Global  constant  and  data  flow 

Description:  Flag  that  indicates  to  get  string  that  irput  should 

come  only  from  the  terminal. 

Makeup:  Char 

Source:  Declared  in  icecappc 

Destination: 

Used  In: 


.  % 


Name: 

A1 iases : 

term__length 

None 

Type  Of  Entry:  Global  constant 

Description 
Make  up: 

:  This  is 

Integer 

the  length  of 

the  terminal  data  a 

Source : 

Dest inat ion 

Declared  in 

msdwcons 

Used  In: 

icecappc , 

msdwtype , 

graphics , 

nographics , 

highlight , 

nohighlight , 

gotoxy, 

clear , 

clearscreen , 

videolow, 

svideolow, 

videobold , 

ELLE:  DATA 
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svideobold,  get_data 


Name:  tf_file 

Aliases:  None 

Type  Of  Entry:  Variable  1 

Description:  This  is  a  file  of  polynomial. 

Make_up:  File  of  polynomial 

Source: 

Destination: 

Used  In:  move_tf 

★★*★***★**************★★★★**★*★★***★***★★★★★*★*******★****★*★★***★ 


Name:  third 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  either  a  polynomial  or  a  matrix. 

Make_up:  polynomial  or  matrix 

Source: 

Destination: 

Used  In:  ppoly,  mmatrix 


****************************************************************** 
Name:  title_slide 

Type:  Procedure 

Description:  This  procedure  displays  the  system  title  slide.  It 
demonstrates  that  at  a  minimum  the  terminal  control 
codes  have  been  initialized  properly. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  term_dat 

Returned:  None 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  clear,  gotoxy,  highlight, 

nohighlight,  rectangle 
Called  By:  get_data 

Version:  3.0 

Date:  22  Jul  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  GETDAT.PAS 

****************************************************************** 
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****************************************************************** 
Name:  trans 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  This  variable  is  the  flag  that  indicates  whether 

the  transaction  fil,e  is  on.  i.e.  should  all 
transactions  be  saved  in  a  file. 

Make_up:  Boolean 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  icecappc,  out_string,  bld_stat_line, 

out_int,  get_data,  out_real 

****************************************************************** 

********************************************************:«x******** 

Name :  TRANSACT . I ON 

Type:  File 

Description:  This  file  contains  the  user  /  SW  transaction 

history. 

Used  In:  get_data 

****************************************************************** 
Name:  trans_file 

Aliases:  None 

Type  Of  Entry:  Global  file  variable 

Description:  This  file  contains  the  user  /  SW  transaction  history 

It  may  be  turned  on  and  off  by  the  user  with  trans. 
Make_up:  Text 

Source:  Declared  in  icecappc 

Destination: 

Used  In:  out_string,  outint 

*********************************»******************************** 

****************************************************************** 

Name:  trans_f i le_name 

Aliases:  None 

Type  Of  Entry:  Global  variable 

Description:  The  name  of  the  file  that  contains  the  user  /  SW 

transaction  history.  It  is  turned  on  and  off  by  the 
user . 

Make_up:  Paramstring 

Source:  Declared  in  ICECAPP 

Dest inat ion: 

Used  In:  icecappc,  get_data 

****************************************************************** 


Type:  Procedure 

Description:  This  procedure  removes  any  trailing  characters  from 

a  cmdword. 


Global  Variables  Used: 
Global  Variables  Changed 
Global  Constants  Used: 
Passed  Variables: 
Returned: 

Files  Read: 

Files  Written: 

Aliases: 

Procedures  Called: 

Called  By: 


None 
None 

wordsizp 
cmdword  : 

cmdword 
None 
None 
None 
None 

displa_conunandword , 


readcom. 


val  n  dec. 


ccopyy , 
get^poly, 
define , 
chgmat , 
polymanip , 
disppoly , 
disp. 


help, 
matrxmanipl , 
disp_matrx, 
inroot , 
polymanip2 , 


gettf , 

matrxmanip2 , 
ppoiy , 
delroot , 
get_poly_name , 
select_rout ine ,  modify, 
disptf,  poly_into_storage. 


poly_f rom_storage,  check_word,  get_poly 

Version:  1.1 

Date:  30  Jun  84 

Author:  Paul  A  Moore,  Capt,  USAF 

Contained  In  File:  TRIM. PAS 

****************************************************************** 


****************************************************************** 
Name:  TRIM. PAS 

Type:  File 

Description:  This  file  removes  any  trailing  characters  from 

a  cmdword. 

Procedures  Contained:  trim 
Version:  1.1 

Date:  30  Jun  84 

Author:  Paul  A  Moore,  Capt,  USAF 

****************************************************************** 


****************************************************************** 
Name:  ttype 

Type:  Procedure 

Description:  This  procedure  acts  as  a  switch  between  two  different 

terminal  types 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  switch,  wchar 
Returned:  None 
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Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 
Called  By:  gotoxy 

Version:  2.0  ; 

Date:  21  Oct  84 

Author:  Paul  A  Moore,  Capt ,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 

*********************************************************  ********* 
Name:  tword 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  a  temporary  storage  location 

for  the  command  word  while  separating  the  individual 
command  words. 

Make_up:  msg_line 

Source : 

Destination : 

Used  In:  readcom 

****************************************************************** 

****************************************************************** 

Name:  typemove 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  used  as  a  flag  to  determine  the 

type  to  move  that  will  be  made:  tf,  poly,  matrix. 
Makeup:  Char 

Source: 

Destination: 

Used  In:  getlocat ion ,  ccopyy 

****************************************************************** 

****************************************************************** 

Name :  u 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  temporary  storage  location  in  roots. 

Make_up:  Real 

Source: 

Dest inat ion : 

Used  In:  roots 

*********  ********************************************************* 

****************************************************************** 
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Name:  UCASE.PAS 

Type:  File 

Description:  This  file  contains  the  procedure  to  convert  a  lower 

case  string  to  upper  case. 

Procedures  Contained:  ucase 
Version:  1.1 

Date:  28  Aug  83  5 

Author:  Vincent  M.  Parisi  II,  Capt ,  USAF 

a***************************************************************** 

****************************************************************** 
Name:  ucase 

Type:  Procedure 

Description:  This  procedure  converts  a  lower  case  string  to  an 
upper  case  string. 

Global  Variables  Used:  None 

Global  Variables  Changed:  None 
Global  Constants  Used:  None 

Passed  Variables:  instring 
Returned:  instring 

Files  Read:  None 

Files  Written:  None 

Aliases:  None 

Procedures  Called:  None 

Called  By:  readcom,  chgmat,  get_poly_name,  get_matrx_name 

Version:  1.1 

Date:  28  Aug  83 

Author:  Vincent  M.  Parisi  II,  Capt,  USAF 

Contained  In  File:  UCASE.PAS 

****************************************************************** 

★★★a************************************************************** 

Name:  ui 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  temporary  storage  location  in  roots. 

Makeup:  Real 

Source: 

Destination : 

Used  In:  roots 

****************************************************************** 

****************************************************************** 
Name:  update 

Type:  Procedure 

Description:  This  procedure  copyies  the  ICECAP  ’ tf&pols.dat '  and 

the  'matrix.dat'  files  into  a  user  specified  file. 
Global  Variables  Used:  abort  command 
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Global  Variables  Changed:  None 

Global  Constants  Used:  as_assigned,  blanks,  crt_oniy, 

Passed  Variables:  None 

Returned:  None 

Files  Read:  TF&POLS . DAT ,  MATRIX.DAT 

Files  Written:  user  specified  fjle  name 

Aliases:  None  ; 

Procedures  Called:  clear,  gotoxy,  disp_msg, 

get_strng,  pause,  clear_msg, 

out_string 

Called  By:  select_routine 

Version:  2.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt ,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 
Contained  In  File:  UPDATE. PAS 

********★********★***★***★**★*★★★*★★★★★******★*★★★******★********★ 


★ 


Name:  update_msg 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  variable  is  the  number  of  the  help  message  for 

the  update  command. 

Makeup:  Integer 

Source: 

Destination: 

Used  In:  help 


Name :  UPDATE . PAS 

Type:  File 

Description:  This  file  copies  the  ICECAP  ' tf fcpols.dat '  and 

the  'matrix.dat'  files  into  a  user  specified  file. 
Procedures  Contained:  update 
Version:  2.0 

Date:  19  Sep  85 

Author:  Susan  K.  Mashiko,  Capt,  USAF 

Gary  C.  Tarczynski,  Capt,  USAF 


Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  temporary  storage  location  in  roots. 

Make_up:  Real 
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roots 


Source : 
Destination: 
Used  In: 


*********************************************************^******** 
Name:  val_n_dec  ' 

Type:  Procedure 

Description:  This  procedure  validates  and  decodes  the  command 
line  input  by  the  user.  The  process  begins  by 
recovering  record  1  from  the  syntax  table,  using 
getline.  Compares  to  first  word  in  the  command  buffer 
If  there  is  no  error  the  process  repeats  itself 
is  a  valid  command.  If  there  are  any 
flag  is  set  and  a  error  message  displayed 


until  there 
anomolies  a 
to  the  user. 

Global  Variables  Used:  cmdbuffer, 

Global  Variables  Changed:  cmdbuffer, 

Global  Constants  Used:  DONEWORD, 

Passed  Variables:  level, 

num_of_commands , 
level,  rec_num, 
cmdbuffer. 

None 
None 
None 

check_word,  get_line, 


Returned: 

Files  Read: 

Files  Written: 
Aliases: 

Procedures  Called: 
Called  By:  get_cmd 


call_rout ine 
call_rout ine 
ENDCODE 
rec_num, 
cmdbuffer , 
error_code , 
call  routine 


error_code , 
call_routine 
num  of  commands 


trim 


Version: 
Date : 
Author : 
Contained 

********** 


1.6 

16  Aug  83 
Vincent  M 


In  File: 


Parisi  II,  Capt ,  USAF 


VALNDEC . PAS 


in  i.  i.  -i.  •  v  num/uv.  •  t  nu 

******************************************************** 


****************************************************************** 
Name:  VALNDEC. PAS 

Type:  File 

Description:  This  file  validates  and  decodes  the  command 

line  input  by  the  user.  The  process  begins  by 
recovering  record  1  from  the  syntax  table,  using 
getline.  Compares  to  first  word  in  the  command  buffer 
If  there  is  no  error  the  process  repeats  itself 
until  there  is  a  valid  command.  If  there  are  any 
anomolies  a  flag  is  set  and  a  error  message  displayed 
to  the  user. 

Procedures  Contained:  check_word,  val_n_dec 

Version:  1.7 

Date:  29  Aug  83 
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Cl 


u 


(3 


Author:  Vincent  M  Parisi  II,  Capt,  USAF 

★***************************************************************** 

****************************************************************** 

Name:  vi 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Used  as  a  temporary  storage  location  in  roots. 

Make_up:  Real 

Source: 

Destination: 

Used  In:  roots 

******************************************************  ************ 

****************************************************************** 
Name:  videobold 

Type:  Procedure 

Description:  This  procedure  writes  the  char  string  to  put  the 

screen  into  bold  video. 


Global  Variables 

Used: 

term 

Global  Variables 

Changed: 

None 

Global  Constants 

Used:  • 

term_length 

Passed  Variables: 

None 

Returned: 

None 

Files  Read: 

None 

Files  Written: 

None 

Aliases : 

None 

Procedures  Called 
Called  By: 

.:  None 

Version:  1.0 

Date:  27  Sep  84 

Author:  Paul 

A.  Moore 

,  Capt ,  USAF 

Contained  In  File:  TERMINAL. PAS 

****************************************************************** 

****************************************************************** 
Name:  videolow 

Type:  Procedure 

Description:  This  procedure  writes  the  char  string  to  put  the 

screen  into  low  video. 


Global  Variables 

Used: 

term 

Global  Variables 

Changed: 

None 

Global  Constants 

Used: 

term  length 

Passed  Variables 

:  None 

Returned : 

None 

Files  Read: 

None 

Files  Written: 

None 

Al  iases : 

None 
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Procedures  Called:  None 
Called  By: 

Version:  1.0 

Date:  27  Sep  84 

Author:  Paul  A.  Moore,  Capt ,  US^.F 

Contained  In  File:  TERMINAL. PAS  ; 

****************************************************************** 

****************************************************************** 

Name :  w 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Generally  used  as  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 

****************************************************************** 
Name:  wchar 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  used  as  a  switch  between  terminal  types. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  ttype 

****************************************************************** 

****************************************************************** 
Name:  width 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  the  width  of  the  triangle  in  columns. 

Make_up:  Integer 

Source: 

Destination : 

Used  In:  rectangle 

****************************************************************** 

****************************************************************** 

Name:  wordlength 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  This  is  the  length  of  word  in  storage. 

Make_up:  Integer  (9) 

Source:  Declared  in  msdwcons 
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Destination: 

Used  In:  msdwtype,  get_line 

****************************************************************** 

****************************************************************** 
Name:  word_num 

Aliases:  None  ; 

Type  Of  Entry:  Variable 

Description:  Pointer  to  the  word  in  the  command  buffer  that  is 

to  be  displayed  on  the  crt. 

Make_up:  Integer 

Source:  get_cmd,  proces_error 

Destination: 

Used  In:  displya_commandword 

****************************************************************** 

****************************************************************** 

Name:  wordnumber 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  the  number  of  words  in  the  command  buffer. 

Make_up:  Integer 

Source : 

Destination: 

Used  In:  help,  define,  disp,  mmatrix,  modify, 

ppcly,  inroot,  delroot,  get_poly_name 
****************************************************************** 

****************************************************************** 
Name:  words ize 

Aliases:  None 

Type  Of  Entry:  Global  constant 

Description:  Size  of  string  for  internal  command  words 

Make_up:  Integer  (12) 

Source:  Declared  in  ICECAPP 

Destination:  N/A 

Used  In:  icecappc,  get_line,  trim, 

val_n_dec,  displa_command,  help, 

select 

****************************************************************** 

****************************************************************** 
Name:  wordtype 

Aliases:  None 

Type  Of  Entry:  Global  type  definition 

Description:  Type  definition  of  a  string  of  length  wordlength. 

Make_up:  wordtype  =  string[  wordlength  ] 

Source:  Declared  in  msdwtype 

Destination : 
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i  i .hi  iu.h.iu 


Used  In: 

****************************************************************** 

****************************************************************** 
Name:  yes 

Aliases:  None 

Type  Of  Entry:  Global  constant  ; 

Description:  Boolean  variable 

Make_up:  Boolean 

Source:  Declared  in  ICECAPP 

Destination:  N/A 
Used  In: 

****************************************************************** 

***************************************************************** 
Name:  your_name 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  This  is  the  user  defined  name  for  the  disk  files  for 

the  storage  of  ’tfS.pols.dat'  and  matrix.dat'. 
Make_up:  msg_line 

Source: 

Destination : 

Used  In:  recover,  update 

****************************************************************** 

****************************************************************** 

Name :  z 

Aliases:  None 

Type  Of  Entry:  Variable 

Description:  Generally  used  as  a  counter. 

Make_up:  Integer 

Source: 

Destination: 

Used  In:  roots 

****************************************************************** 
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Appendix  E:  System  Software 


Introduction 

This  file  contains  a  cross  index  listing  for  procedures 
and  source  files.  The  source  files  are  indicated  by  capital 
or  upper  case  letters  while  the  functions  and  procedures  are 
indicated  by  the  lower  case  letters. 


BUILDDAT 

This  is  the  cross  index  for  the  menu  installation  pron- 
ram  BUILDDAT.  These  files  were  not  changed  during  this  thesis 
effort,  as  a  result,  the  code  for  the  following  BUILDDAT  files 
is  not  included  here.  The  code  may  be  found  in  reference  15  and 
again  in  reference  12,  Capt  Parisi's  MS  Thesis  and  Capt  Moore's 
MS  Thesis  respectively. 

BUILDDAT. PAS 

make_param 
make_terminal 
make_pr inter 
make_help 
bui lddat 


ADDKEY . PAS 

addkeywordtomenu 

ADDTOMEN . PAS 

addtomenu 

ADDWORD . PAS 

addword 

AVL-l.PAS 

create 
isempty 
lchi Id 
rchi Id 
dataval 

AVL-2.PAS 

makebt 

LNR 

displaytree 
pr  inttree 
treedispose 


■  i!  Bju  "u  «u  ■  w  »  v  V  >  J  V  v  >  *  /*  *  ’-.•••- 


AVL-3 .PAS 

lef tbalance 
r ightbalance 


AVL-4.PAS 

avl  insert 
btlocate 

DEFCALL . PAS 

f indcal 1 
addcall 

def ine_call_rout ine 

DEFMENU . PAS 

def ine_menu 

DISPROC.PAS 

callsdispose 

ERRORMSG . PAS 

errormsg 

GETWORD . PAS 

get_word 

LOCMENU . PAS 

copynsenuvord 

locate_menu_node 

MAKEMENU . PAS 

init_menu 

make_menu 

MAKEPROC . PAS 

calc_min_chars 
make_word_l ist 
nuraber_calls 
make_call_re cords 
make_keyw_records 
make_decoding_paths 

MENUCONS . PAS  -  Menu  Constant  Definition  File 

MENUPRNT . PAS 

menu_pr int 

MENUTYPE . PAS  -  Menu  Type  Definition  File 

MSDWCONS . PAS  -  MICROSDW.SYS  Constant  Def.  File 
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ICECAP-PC 


This  list  includes  the  modified  user  interface,  MICP.OSDW 
files  (  12  ),  as  well  as  the  ICECAP-PC  files  created  as  part 
of  this  thesis  effort.  The  identification  codes  are  as  follows 


The  ICECAP-PC  files  are  preceeded  by  two  asterisks 
(**) . 

Any  files  "hat  require  different  versions  for  the 
IBM-PC/AT  XT  and  the  Z-100  is  annotated  with,  Z-100 
and  IBM  versions. 


Any  file  that  is  for  the  IBM-PC/AT/XT  only  is  annota¬ 
ted  with,  IBM  Unique. 

Any  file  that  has  different  versions  for  a  hard  drive 
and  a  floppy  system  is  anno  ated  with,  Hard  and 
Flc  ppy . 


The  files  are  presented  in  the  order  of  this  cross  index. 

**  BODE. PAS 

f  requencyresponse 

**  CONCONS.PAS  -  ICECAP-PC  Constant  Definition  Fil 
**  COPY. PAS 

get_locat ion 
move_t  f 
move_poly 
move_matr ix 
ccopyy 


**  DEFINE. PAS 

get  poly 
def Ine 

**  DELROOT . PAS 

delroot 

**  DISP.PAS 

dispt  f 
disp 

DISPLAYC.PAS 

displa_commandword 


**  FORM. PAS 


poly_f  rom_storage 
poly_into_storage 
form 

GETCOM. PAS 

get_cmd 

**  GETDAT . PAS  (  Z-lGu  and  IBM  versions  ) 
t i t le_sl ide 
bld_stat_l ine 
get_data 

GET I NT. PAS 

getchi 

del_lst_ch 

ck_chr 

out_int 

get_int 

GETLINE . PAS 

get_l ine 

**  GETMAT . PAS 

lef t_bracket 
r ight_bracket 

makejprettylargejmatr ix_one 
make_pretty_largejmatrix_two 
get_matr ix_entr ies 
:nake_pre  1 1  y  sma  1  l_ma  t  r  i  x 
gotmat 

GETSTRIN . PAS 

get_strnc 

**  GETTF.PAS 

get_r_num 
make_pretty 
get_f act 
form_poiy 
get_unf act 
roots 
P°ly 
gettf 

**  HELP. PAS 

help 
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ICECAPPC.PAS  (  Z-100  and  IBM-unique  versions  ) 
(  Hard  and  Floppy  ) 
icecappc 


INROOT. PAS 

inroot 

INSTRUCT. PAS 

instruction 


MATRIX. PAS 

disp_matrx 
matrx_manipl 
matrx_man ip2 
get_matrx_name 
mmatr ix 

MATRXMAN . PAS 

matrxadd 

matrxsub 

mmatrxmlt 

smatrxmlt 

matrxtran 

matrxinv 


MODIFY. PAS 

chgmat 

modify 

MSDWCONS . PAS  -  MICROSDW.SYS  Constant  Def.  File 
MSDWTYPE . PAS  -  MICROSDW.SYS  Type  Def.  File 
MSG . PAS 

disp_line 
cle  ir_msg 
disp_msg 


OUTPUT . PAS 

out_str ing 


PAUSE. PAS 


pause 


POLYMAN. PAS 

polyadd 

polysub 

polymlt 

spolymlt 

POLY. PAS 

disppoly 
polman ip 
polman ip2 
get_poly_name 
ppoly 

PROCESER . PAS 

proces_error 

PROMPTCM . PAS 

prompt_cmd 

PROMPTHE . PAS 

prompt_help 

READCOM . PAS 

readcora 

REALS . PAS 

out_real 

get_real 

RECOVER. PAS 

recover 

SELECT. PAS 

select_rout ine 

STDOUT . PAS  (  IBM  Unique  ) 
standard_output 

TERMINAL. PAS 

graphics 

nographics 

highl ight 

nohighlight 

gotoxy 

clear 

ClearScreen 

VideoLow 

SVideoLow 

VideoBold 


** 


SV ideoBold 
Rectangle 

TRIM. PAS 

trim 

UCASE . PAS 

ucase 

UPDATE . PAS 

update 

VALNDEC . PAS 

check_word 
val  n  dec 
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' POLYO '  then 


if  choice  =  'POLYE'  then  stor_loc 
else 

if  choice  =  'ONPOLY'  then  stor  lo 
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Appendix  F:  BUILDDAT  Text  Files 


This  Appendix  contains  the  five  (5)  text  files  that  are 
used  by  BUILDDAT  to  install  the  menu  system.  These  text 
files  describe  the  hardware  environment  (  TERM.TXT  and 
PRINT.TXT  ),  help  text  (  HELP.TXT  ),  and  the  menu  structure 
(  MENU . TXT  and  PARAM.TXT  ).  These  particular  test  files  were 
developed  for  this  thesis  effort.  If  a  text  file  has  several 
different  versions,  the  particular  machine  and  configuration 
is  annotated  in  the  footer  of  the  text  file. 

These  files  are  in  the  order  which  they  were  presented 
above. 
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